Skip to Content
Messages

Send a message

POST
/v1/numbers/{phone_number}/messages/send

Send one message from {phone_number}. A 200 means queued, not delivered.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

phone_number*string

Your WhatsApp number, digits only, e.g. 393401234567.

Request Body

application/json
  1. body
recipient*string

Recipient phone number in E.164 format, e.g. +393331112222.

Length1 <= length
channel?"whatsapp"

Only whatsapp.

Default"whatsapp"
Value in"whatsapp"
message*

The message content. message_type names the key that holds it: text, image, video, audio, file, location, sticker or template. Each type is described in Send messages.

client_ref?|

Your own reference for this message, e.g. an order ID.

Response Body

OK

application/json
  1. response
message_uuid*string

ID of the message. Use it to read its status and to match status webhooks.

provider*string

The WhatsApp provider that took the message.

channel*"whatsapp"

Always whatsapp.

Value in"whatsapp"
accepted_at*string

When WhaPiù accepted the message, UTC.

Formatdate-time
Example Request
curl -X POST 'https://api.wapiu.ai/v1/numbers/393401234567/messages/send' \  -H 'Content-Type: application/json' \  -d '{  "recipient": "+393331112222",  "message": {    "message_type": "text",    "text": "Hello from WhaPiù!"  },  "client_ref": "order-1234"}'
Example Response
{  "message_uuid": "3f2b8c1e-7a4d-4e9b-9c2a-5d6e7f8a9b0c",  "provider": "meta",  "channel": "whatsapp",  "accepted_at": "2026-11-22T10:15:00Z"}