Browse documentation
Reliability
Retries & idempotency
Failed deliveries retry automatically with exponential backoff. Retries use the same delivery ID, so your destination can safely deduplicate them.
| Attempt | Timing | What happens |
|---|---|---|
| 1 | Immediately | Initial request to the destination. |
| 2 | +30 seconds | Retried after a timeout or 5xx response. |
| 3 | +2 minutes | Backoff doubles each attempt. |
| 4 | +10 minutes | Still using the same delivery ID. |
| 5 | +1 hour | Final attempt, then marked failed and alerted. |
Deduplicate at the destination
Store X-Hooks-Delivery in a unique index before processing. If the same ID arrives again, return 200 without repeating side effects. A 2xx response stops retries immediately.
Rate limits and timeouts also trigger retries. Return a 4xx only when retrying cannot help — for example, a malformed payload or an unknown account.
Was this page helpful?
Tell us if something was missing or unclear.
Ready to try it?Create a free workspace and send your first event.