Skip to main content

Retry attempts

After 7 attempts the delivery is marked dead-lettered. You can view and manually retry dead-lettered deliveries in the console or via the API.

What counts as a failure?

  • Non-2xx HTTP response from your endpoint
  • Connection timeout (10 seconds)
  • DNS failure

Manual retry

Best practices

  • Respond fast: Return 200 immediately and process the payload asynchronously.
  • Be idempotent: The same event may be delivered more than once. Key on data.id + type to deduplicate.
  • Monitor dead-letters: Set an alert when status == "dead_lettered" on deliveries you care about.