Skip to Content
Developers

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"  }'
FieldTypeRequiredDescription
recipientstringYesThe user's number in E.164, e.g. +393331112222.
messageobjectYesThe content. message_type says which key holds it.
message.message_typestringYestext, image, video, audio, file, location, sticker or template.
client_refstringNoYour own reference, e.g. an order ID.
channelstringNoAlways whatsapp, the default.

Message types

message_typeContentWindow
texttext: a string24 h
imageimage: url, caption24 h
videovideo: url, caption24 h
audioaudio: url24 h
filefile: url, name, caption24 h
locationlocation: latitude, longitude, name, address24 h
stickersticker: url or id24 h
templatetemplate: name, parametersAlways

"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"
}
FieldDescription
message_uuidThe message ID. Use it to read its status.
providerThe WhatsApp provider that took the message.
channelwhatsapp.
accepted_atWhen the API accepted the message.

200 means queued, not delivered. Delivery is reported later as a status.

Errors

HTTPcodeWhat to do
404auth_unknown_senderCheck {phone_number}.
422provider_permanentWhatsApp rejected it. Do not retry.
429provider_rate_limitedRetry after retry_after_ms.
503provider_retryableRetry with backoff.

All codes: Errors.

On this page