Sign in
latestOpenAPI 3.1.02026-08-193894215.9 MB

23dfbe1a0d1f

Webhooks

Replay Deliveries in a Range

Re-sends the webhook's past deliveries within a time window, optionally limited to specific events or to messages whose most recent delivery attempt failed. Fire and forget: nothing about the replay is stored, and each re-send appears as a new entry in the webhook's delivery log. Each matching message is re-sent once, by default with its original webhook-id, so consumers that deduplicate are unaffected; pass regenerate_ids to re-send under freshly generated ids instead. Only available for enabled webhooks on API version v1; deliveries are retained for 30 days.

post/webhooks/{id}/replay

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

eventsstring[]

Only replay these event types, in dot form (for example payment.succeeded). Omit to include every event.

failed_onlyboolean

Only replay messages whose most recent delivery attempt in the window failed. Defaults to false. Best-effort: a message whose attempts span processing batches can still be re-sent — replays keep the original webhook-id by default, so consumers that deduplicate are unaffected.

regenerate_idsboolean

Re-send each replayed message under a freshly generated webhook-id (in both the envelope and the signed headers) instead of its original one. Defaults to false. Use this when your endpoint deduplicates on webhook-id and you want it to process the replays as new messages.

sent_afterstring required

Start of the delivery window to replay, as an ISO 8601 timestamp. Clamped to the 30-day delivery retention.

sent_beforestring

End of the delivery window to replay, as an ISO 8601 timestamp. Defaults to now.

Example request

{
  "failed_only": true,
  "regenerate_ids": true,
  "sent_after": "2026-01-01T12:00:00.000Z"
}

Response

replay queued

queuedboolean required

Whether the replay was accepted. Watch the webhook's delivery log for the re-sends.

Example response

{
  "queued": true
}