Send batch messages

Send up to 10,000 messages in a single API call. Each message in the batch
is validated independently — some may be accepted while others are rejected.

The total cost is reserved from your balance upfront. If the batch would
exceed your balance, the entire batch is rejected.

Each accepted message gets its own message_id for individual tracking.
Messages inherit default values for any omitted optional fields.

Idempotency: Use the X-Idempotency-Key header to make the entire
batch idempotent.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
messages
array of objects
required
length between 1 and 10000

Array of messages to send (1–10,000)

messages*
Headers
uuid

Unique key (UUID recommended) to ensure the request is processed only once.
If the same key is sent again within 24 hours, the original response is returned.

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json