Skip to main content
If your endpoint doesn’t return a successful response, storekit will retry the webhook multiple times with exponential backoff.

What Counts as a Failure?

A webhook delivery is considered failed if:
  • Your endpoint returns a non-2xx status code
  • Your endpoint doesn’t respond within 30 seconds
  • The connection to your endpoint fails

Retry Schedule

Failed webhooks are retried with exponential backoff over about 28 hours: After all retry attempts are exhausted, the webhook is marked as failed.

Endpoint Disabling

If all delivery attempts to a specific endpoint fail for a period of 5 consecutive days, the endpoint will be automatically disabled to prevent further failed deliveries. To re-enable a disabled endpoint:
  1. Open Settings → Webhooks in the dashboard
  2. In the embedded webhooks portal, find the disabled endpoint
  3. Re-enable it

Manual Retries

You can manually retry failed webhooks from the dashboard:
  1. Go to your webhook endpoint details
  2. Find the failed message in the logs
  3. Click Retry to resend

Recovering from Outages

If your service experiences downtime, you can recover missed webhooks:
  1. Open Settings → Webhooks and open your endpoint in the embedded webhooks portal
  2. Use Recover Failed to resend every failed message since a date you choose, or Replay Missing to send messages that were never attempted for that endpoint
Design your webhook handler to be idempotent so that receiving the same webhook multiple times doesn’t cause issues.