Skip to content

Webhook retries and idempotency

Which responses are retried, the backoff schedule, dead letters, and handling duplicate events.

Core

Responses

ResponseBehavior
2xxTreated as delivered
Timeout or 5xxRetried with backoff
408 or 429Retried with backoff
Other 4xxTreated as a permanent failure (not retried)

Backoff and dead letters

  • Fajita retries with increasing delays up to a maximum number of attempts.
  • After the final attempt, the delivery moves to a dead-letter state.
  • You can inspect and manually retry a dead-lettered delivery.

Idempotency and ordering

Delivery is at-least-once and Fajita does not guarantee strict global ordering. Use timestamps and event ids to reconcile state.

Was this page helpful?