Designing retry-friendly handlers
- Always respond with a 2xx status once you persist the event.
- Use the
event_idfield to de-duplicate retries. - Store the complete payload for observability and later replay.
Recommended backoff schedule
- Immediate retry after 30 seconds.
- Second attempt at 2 minutes.
- Third attempt at 10 minutes with a notification to your on-call channel.
Testing locally
Use the built-in webhook replay panel inside the Example docs to trigger events on demand and inspect delivery history.