Skip to main content

Retry attempts

AttemptDelay after previous
1 (initial)
230 seconds
35 minutes
430 minutes
52 hours
68 hours
724 hours
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

curl -X POST \
  https://api.framelane.io/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retry \
  -H "Authorization: Bearer $FRAMELANE_API_KEY"

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.