Skip to main content
POST
Keys requiring send approval receive 403 confirmation_required for direct sends. Use pending sends for approved single or bulk SMS. Pending sends do not support MMS. Send up to 1,000 messages in a single API call. A batch may mix SMS messages without media and MMS messages with hosted attachments. Each message is validated independently; successfully validated messages are queued even if others fail validation. A 201 response reports queue results, not delivery. Inspect queued_count and errors.

Body Parameters

array
required
Array of message objects (maximum 1,000 per request). Each object supports the following fields:

Response Fields

integer
Number of messages successfully queued for delivery.
integer
Number of messages that failed validation or queueing.
array
Array of error objects for messages that failed validation or queueing. Each object contains:

Examples

Error Codes

Request-Level Errors

Individual failures appear in errors. Partial success returns 201. When nothing was confirmed queued, a publication failure returns 502; unavailable MMS or number authority can return 503. A failure to durably record rejected messages can also return 503. Authenticated requests can also fail with 401 invalid_credentials, 403 account_suspended, or 429 rate_limited — see Error Codes.

Per-Message Errors

Returned as code inside each failed entry of the response’s errors[] array.

Next Steps

Campaign Execution

How messages flow from queue to delivery

Create Contact

Add contacts before sending