Retries and disabling
When Lidmeo retries a delivery, when it stops, and how to send again by hand.
A delivery is one event to one endpoint. It succeeds when your server answers a 2xx code within 15 seconds. Anything else (another code, a redirect, a timeout, a failed connection) is a failure, and the delivery is retried.
The schedule
8 attempts at most, each after the previous one failed:
| Attempt | When |
|---|---|
| 1 | as soon as the event is recorded |
| 2 | 5 s after the previous failure |
| 3 | 5 min after the previous failure |
| 4 | 30 min after the previous failure |
| 5 | 2 h after the previous failure |
| 6 | 5 h after the previous failure |
| 7 | 10 h after the previous failure |
| 8 | 10 h after the previous failure |
Retries leave on the deliverer's next pass, which runs every minute: a short delay can therefore last up to a minute.
At least once
An event can reach you twice (an interrupted attempt, a response lost on the way). The webhook-id header is the event's id, the same on every attempt: keep the ones you processed and ignore a duplicate.
Disabling
After 5 days without a single successful delivery, the endpoint is disabled (status: "disabled", disabled_reason: "failing"), its pending deliveries are canceled and an e-mail tells you, once. Enable it again from Lidmeo (Assistant IA et intégrations, AI assistant and integrations; Pour les développeurs, for developers; Webhooks section, Réactiver, enable again) or with PATCH /v1/webhook_endpoints/{id} and { "status": "enabled" }. The events of the period stay readable 30 days through GET /v1/events: catch up from there.
Sending again by hand
GET /v1/webhook_endpoints/{id}/deliveries lists the deliveries (status, attempts, code and excerpt of the response). POST /v1/webhook_endpoints/{id}/deliveries/{delivery_id}/retry makes an attempt right away; a delivery still pending then keeps its schedule. In Lidmeo, the "Renvoyer" button does the same.
Changing the secret
POST /v1/webhook_endpoints/{id}/rotate_secret creates a new secret, shown only once. The old one still signs for 24 hours by default (expire_previous_in, from 0 to 7 days): meanwhile, every delivery carries two signatures, and your server accepts either while it switches to the new one.
Retention
Events and their deliveries are kept 30 days, then erased. An account has at most 16 webhook endpoints.