Replay failed deliveries
POST
/v1/webhooks/{webhook_id}/replay
curl -X POST "https://us1.platform.bird.com/v1/webhooks/{webhook_id}/replay" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"since": "2026-05-07T00:00:00Z",
"until": "2026-05-07T23:59:59Z"
}'Queues redelivery of deliveries that failed. The window runs from since
(default: the last 24 hours) to until, and events the endpoint already received
successfully are skipped, so a replay never double-delivers.
Only failed attempts are replayed. An event the endpoint was never sent, such as one
that arrived while it was paused, has no failed attempt to replay, so a replay does
not recover it.
The 202 response means the replay is queued. Events are redelivered asynchronously
and retried like any other delivery; no count or task ID is returned, so track results
with List delivery attempts.
Replays are limited to 20 per organization per UTC day; beyond that the request
returns a 429 WebhookReplayQuotaExceeded.
Paramètres
webhook_id
string
ID of the webhook endpoint (whk_ prefix), as returned when it was created.
Corps de la requête
since
string
Replay events that occurred at or after this timestamp. Defaults to 24 hours before the request when omitted.
until
string
Replay events that occurred before or at this timestamp. Omit to bound the window only by since.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideWebhooks done right: reliable delivery eventsComprendre le conceptHow do I verify a webhook signature?Suivre le parcours d'apprentissageOperate messaging reliablyGuide d'implémentationWebhooks & events
Essayez la pratique et obtenez un guide d'implémentation