curl -X DELETE https://api.tracklysms.com/api/v2/pending-sends/66f1c2a9b8e4d3f0a1b2c3d4 \
-H "X-Api-Key: trk_your_api_key"
{
"id": "66f1c2a9b8e4d3f0a1b2c3d4",
"status": "cancelled",
"kind": "send",
"recipient_count": 1,
"decided_at": "2026-09-04T14:15:40.000000Z",
"decided_by": "api_key:66e0a1b2c3d4e5f6a7b8c9d0",
"decision_reason": null,
"result": null,
"last_error": null
}
{ "error": "Only a pending or approved send can be cancelled", "code": "pending_send_not_open", "status": "sent" }
Pending Sends (v2)
Cancel a Pending Send
Withdraw a held send before it is executed.
DELETE
/
v2
/
pending-sends
/
{id}
curl -X DELETE https://api.tracklysms.com/api/v2/pending-sends/66f1c2a9b8e4d3f0a1b2c3d4 \
-H "X-Api-Key: trk_your_api_key"
{
"id": "66f1c2a9b8e4d3f0a1b2c3d4",
"status": "cancelled",
"kind": "send",
"recipient_count": 1,
"decided_at": "2026-09-04T14:15:40.000000Z",
"decided_by": "api_key:66e0a1b2c3d4e5f6a7b8c9d0",
"decision_reason": null,
"result": null,
"last_error": null
}
{ "error": "Only a pending or approved send can be cancelled", "code": "pending_send_not_open", "status": "sent" }
Moves a
Also
pending or approved send to cancelled. Use it when the agent’s plan changes or the message is no longer wanted; an approved send that is never executed lapses on its own at expires_at. Returns the updated pending send. Cancellations are written to the account activity log as pending_send.cancelled, and still count toward the 500 holds per 24 hours.
Path Parameters
string
required
Pending send ID.
Errors
| HTTP Status | Error Code | Description |
|---|---|---|
| 404 | not_found | No pending send with this ID on the account. |
| 409 | pending_send_not_open | The send is executing, unknown_execution, sent, rejected, cancelled, or expired; the response’s status says which. |
401 invalid_credentials.
Examples
curl -X DELETE https://api.tracklysms.com/api/v2/pending-sends/66f1c2a9b8e4d3f0a1b2c3d4 \
-H "X-Api-Key: trk_your_api_key"
{
"id": "66f1c2a9b8e4d3f0a1b2c3d4",
"status": "cancelled",
"kind": "send",
"recipient_count": 1,
"decided_at": "2026-09-04T14:15:40.000000Z",
"decided_by": "api_key:66e0a1b2c3d4e5f6a7b8c9d0",
"decision_reason": null,
"result": null,
"last_error": null
}
{ "error": "Only a pending or approved send can be cancelled", "code": "pending_send_not_open", "status": "sent" }