Send Text Message
Supported & TestedSend a text message from a connected Waplix instance to a WhatsApp number.
POSThttps://api.waplix.io/api/v1/messages/send
Authentication
Authorization: Bearer YOUR_API_KEY Parameters Specification
| Parameter | Type | Required | Description |
|---|---|---|---|
| instance_id | string | Required | The unique Waplix instance ID slot |
| number | string | Required | Recipient phone number with country code (digits only) |
| message | string | Required | Message content text body (supports emojis and newlines) |
instance_id
stringReq The unique Waplix instance ID slot
number
stringReq Recipient phone number with country code (digits only)
message
stringReq Message content text body (supports emojis and newlines)
Usage Notes
Verified on production. Public documentation uses sanitized example data only.
Request Payload Example
Request
curl -X POST "https://api.waplix.io/api/v1/messages/send" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"instance_id": "demo_instance",
"number": "15551234567",
"message": "Hello from Waplix API docs."
}'Success Response
Response · 200 OK
{
"success": true,
"message_id": "MSG_DEMO_001",
"status": "sent"
} Related Webhook Events
The API response confirms that Waplix accepted or processed the request. Delivery and read updates may arrive asynchronously through configured webhooks.
message.sentDocs →
Triggered when Waplix successfully sends the message to the WhatsApp network.
{
"event": "message.sent",
"instance_id": "demo_instance",
"to": "15551234567@s.whatsapp.net",
"message_type": "text",
"message": "Hello from Waplix API docs.",
"message_id": "MSG_DEMO_001",
"timestamp": 1782582255
}message.deliveredDocs →
Triggered when the recipient's phone receives and acknowledges the message.
{
"event": "message.delivered",
"instance_id": "demo_instance",
"message_id": "MSG_DEMO_001",
"chat_id": "15551234567@s.whatsapp.net",
"from": null,
"to": "15551234567@s.whatsapp.net",
"message_type": "text",
"status": "DELIVERY_ACK",
"receipts": [],
"timestamp": 1782582256
}message.readDocs →
Triggered when the recipient opens and reads the message (blue ticks).
{
"event": "message.read",
"instance_id": "demo_instance",
"message_id": "MSG_DEMO_001",
"chat_id": "15551234567@s.whatsapp.net",
"from": null,
"to": "15551234567@s.whatsapp.net",
"message_type": "text",
"status": "READ",
"receipts": [],
"timestamp": 1782582256
} Was this page helpful?