curl -X POST https://api.tracklysms.com/api/v2/webhooks/deliveries/66d1a8d95b2e4c3f0d4b2e6f/replay \
-H "X-Api-Key: trk_your_api_key"
{ "delivered": true, "statusCode": 200, "responsePreview": "ok" }
Webhooks (v2)
Replay a Delivery
Request a fresh attempt for one retained delivery, reusing its original event_id.
POST
/
v2
/
webhooks
/
deliveries
/
{delivery_id}
/
replay
curl -X POST https://api.tracklysms.com/api/v2/webhooks/deliveries/66d1a8d95b2e4c3f0d4b2e6f/replay \
-H "X-Api-Key: trk_your_api_key"
{ "delivered": true, "statusCode": 200, "responsePreview": "ok" }
Requests a fresh attempt for one retained delivery and waits up to 15 seconds for its result. The re-delivery reuses the original
event_id, so your dedupe logic handles it. To re-send many at once, use Bulk Replay.
A 200 response reports the completed attempt, including an unsuccessful receiver response: delivered is a boolean, statusCode is the receiver’s status or null for a transport failure, and responsePreview is its response preview. Acceptance alone never produces this response. Replay uses the current URL and signing secret of the original endpoint, even if its subscriptions have changed.
If waiting for the result fails or times out, the API returns 500 internal_error. Check the delivery history before retrying. A fresh pending replay or retry returns 409 replay_conflict. Automatic recovery of accepted replay work after this error is part of a staged delivery update; its availability depends on that release, and this page does not establish that it is active for your account.
Path Parameters
The delivery’s id (from List Deliveries).
Examples
curl -X POST https://api.tracklysms.com/api/v2/webhooks/deliveries/66d1a8d95b2e4c3f0d4b2e6f/replay \
-H "X-Api-Key: trk_your_api_key"
{ "delivered": true, "statusCode": 200, "responsePreview": "ok" }
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 404 | not_found | No delivery with that id on the account. |
| 409 | replay_conflict | A fresh retry or replay is already pending for this delivery. |
| 409 | endpoint_inactive | The delivery’s endpoint is disabled. |
| 429 | rate_limit_exceeded | Too many replays; see Retry-After. |
| 500 | internal_error | The result could not be obtained. Check history before retrying; automatic recovery of accepted work is a staged addition. |