Skip to main content
POST
Send a WABA message to a phone number

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

A JSON describing the recipient and message payload, or a multipart/form-data upload of a file with an optional text caption.

Exactly one of text, file_uid, or template must be provided (a file may be sent together with a text caption; template cannot be combined with text, file_uid, or a file upload). waba_account_id and phone are required when sending without a chat id (i.e. via POST /waba/messages); they are ignored when sending into an existing chat.

text
string

Free-text message or caption for file_uid.

Example:

"Hello"

file_uid
string

Previously uploaded Public API file UID.

template
object
waba_account_id
integer

Required when sending without a chat id.

Example:

4021

phone
string

Required when sending without a chat id.

Example:

"+15551230000"

Response

Message accepted for async sending

status
enum<string>
required
Available options:
ok,
error
Example:

"ok"

data
object
required