SendSmsBatch
POST
/sms/v1/deliver/batch
Last modified:2026-09-09 04:02:32
registered. Delivery happens afterwards.
Limits
the same country: mixing a Colombian and a Mexican number in one batch is rejected.
Idempotency without doing anything
Idempotency-Key header is optional. When it is absent, the key is derivedfrom the request content within a 15-minute window, so two identical calls in a row
create one campaign and the second one gets the first back. This protects against
the double submit, which is the failure that actually happens.
body returns the original campaign; the same key with a different body returns 409.
Credit is not checked here
POST /sms/v1/deliver, a batch is accepted with 200 and charged later, when theworker expands the file. A client with no balance still gets a 200 and the campaign
simply never sends. Check the campaign in the portal to confirm delivery.
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.trucontact.co/sms/v1/deliver/batch' \
--header 'Idempotency-Key: order-48213-retry-1' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"batchName": "Payment reminder",
"recipients": [
"+573001234567",
"+573007654321"
],
"messageBody": "Your invoice is due tomorrow.",
"validateDuplicates": false
}'Response Response Example
200 - Example 1
{
"campaignId": "66fa1b2c3d4e5f0011223344",
"status": "CampaignQueued",
"acceptedCount": 2
}Modified at 2026-09-09 04:02:32