Deliveries & retries

Deliveries are queued instantly and dispatched every 5 minutes, so an event typically arrives within a few minutes. Your endpoint must answer within 10 seconds; any 2xx status counts as delivered.

Failed deliveries are retried up to five times: after 1, 5, 30, 120 and 360 minutes. If the last attempt fails, the delivery is marked as failed in the log and not tried again. Deactivating or deleting an endpoint stops its queued deliveries.

Use the test button in Settings → Webhooks to send a test.ping event to your endpoint. Every delivery – successful or not – appears in the delivery log with status, attempts, response code and error message.

• Verify the signature before doing anything else.
• Answer fast with 2xx and process the event asynchronously.
• Handle duplicates idempotently – a retried delivery can arrive twice.
• Rotate the endpoint secret if it may have been exposed.