Send a message
The request and response every message type shares.
POST
/v1/numbers/{phone_number}/messages/sendReference →
One endpoint sends every message type. {phone_number} is the number you send from. The body says who receives the message and what it contains.
Request
curl -X POST "$WAPIU_API/v1/numbers/$WAPIU_NUMBER/messages/send" \ -H "Authorization: Bearer $WAPIU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "recipient": "+393331112222", "message": { "message_type": "text", "text": "Your order A1234 has shipped" }, "client_ref": "order-1234" }'| Field | Type | Required | Description |
|---|---|---|---|
recipient | string | Yes | The user's number in E.164, e.g. +393331112222. |
message | object | Yes | The content. message_type says which key holds it. |
message.message_type | string | Yes | text, image, video, audio, file, location, sticker or template. |
client_ref | string | No | Your own reference, e.g. an order ID. |
channel | string | No | Always whatsapp, the default. |
Message types
message_type | Content | Window |
|---|---|---|
text | text: a string | 24 h |
image | image: url, caption | 24 h |
video | video: url, caption | 24 h |
audio | audio: url | 24 h |
file | file: url, name, caption | 24 h |
location | location: latitude, longitude, name, address | 24 h |
sticker | sticker: url or id | 24 h |
template | template: name, parameters | Always |
"24 h" types reach the user only inside the messaging window.
Response
{
"message_uuid": "aaaaaaaa-bbbb-cccc-dddd-000000000000",
"provider": "meta",
"channel": "whatsapp",
"accepted_at": "2026-11-22T10:00:00Z"
}| Field | Description |
|---|---|
message_uuid | The message ID. Use it to read its status. |
provider | The WhatsApp provider that took the message. |
channel | whatsapp. |
accepted_at | When the API accepted the message. |
200 means queued, not delivered. Delivery is reported later as a status.
Errors
| HTTP | code | What to do |
|---|---|---|
| 404 | auth_unknown_sender | Check {phone_number}. |
| 422 | provider_permanent | WhatsApp rejected it. Do not retry. |
| 429 | provider_rate_limited | Retry after retry_after_ms. |
| 503 | provider_retryable | Retry with backoff. |
All codes: Errors.