- Return a
2xxresponse as soon as the event is durably accepted. - Move longer work to an asynchronous queue.
- Make event processing idempotent.
- Store processed
event_idvalues so duplicate deliveries are safe. - Do not rely on events arriving in order.
- Reconcile important resource state through the API.
Webhooks
Webhook retry behavior
Design webhook consumers for reliable event processing.
The public v1 contract does not yet define webhook retry timing, retry limits, or timeout behavior.
Build your consumer defensively:
