EVT-27Recommended
Retry until the receiver accepts
Treat any answer other than 2xx as a failure, and retry with growing gaps for a documented time.
How to do it
Wait at most 15 seconds for each answer, and don't follow redirects. Retry for at least 24 hours, with backoff and jitter. Then mark the endpoint as failing and tell its owner. Let receivers replay missed events from an events list. Receivers that miss events catch up with a sweep, as Sweep for missed events every hour shows.
How to check
Point a test webhook at an endpoint that answers 500. The sender retries with growing gaps, and the event can be fetched afterwards.
Sources
Related rules
- PAY-20 Sweep for missed events every hour in Payments and billing
- EVT-29 Let customers test and inspect their webhook endpoints in Integration and events
For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/events/webhooks/webhook-retries">Agent Wranglers integration and events playbook</a>. In code you write, add a comment next to it with the same link.