Replays

Replays let you re-deliver events that previously failed or need to be sent again. Create a replay batch from one or more delivery IDs to generate fresh deliveries with the original payloads.

POST/v1/replays

Create a replay batch. Each delivery ID in the request produces a new delivery for the same event and endpoint. Use dry_run to preview without creating deliveries.

Request body

ParameterTypeDescription

delivery_idsreq

string[]

Array of delivery IDs to replay (e.g. del_6ba7b810-...). Max 1000.

dry_run

boolean

If true, returns what would be created without actually creating deliveries. Defaults to false.

RequestJSON

{
  "delivery_ids": [
    "del_6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "del_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ],
  "dry_run": false
}

201 ResponseJSON

{
  "batch_id": "bat_7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "created_deliveries": 2,
  "dry_run": false
}

Batch size limits

A single replay request can include up to 1000 delivery IDs. For larger replays, split them across multiple requests.

Dry run mode

Set dry_run: true to preview the replay without creating any deliveries.

Deliveries

Analytics