Paid Plans5 min read· Updated 2026-11-18
Send WhatsApp Message API
Send WhatsApp text, image, video, audio, and document messages programmatically via POST /api/v1/developer/whatsapp/messages.
Endpoint specification
POST
/api/v1/developer/whatsapp/messagesSend a WhatsApp text or media message on behalf of your connected tenant WABA.
Auth: X-API-Key or Authorization: Bearer oc_...Paid Plans (Developer API enabled)
Request Body Parameters (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
| to | string | Yes | Recipient WhatsApp phone number in E.164 or digits format (e.g., "15551234567" or "+923152468856"). |
| type | string | No (default: "text") | One of: "text", "image", "video", "audio", "document". |
| message | string | Yes | Text body when type is "text", or public HTTPS media URL for media types. |
| caption | string | No | Optional caption for "image", "video", or "document" messages (ignored on "audio"). |
Request & response examples
Send Text & Media Examples
curl --request POST "https://api.omnichatstack.com/api/v1/developer/whatsapp/messages" \
--header "Authorization: Bearer oc_your_api_key_here" \
--header "Content-Type: application/json" \
--data '{
"to": "923152468856",
"type": "text",
"message": "Your order #1042 has shipped!"
}'