Send message

Sends a WhatsApp message to a recipient. The type field determines the structure of the body and which additional object must be included (for example, text, image, template).

Authentication

x-api-keystring
Account authentication key.

Request

This endpoint expects an object.
tostringRequired
Destination number in E.164 format.
typeenumRequired
textobjectOptional
imageobjectOptional
videoobjectOptional
audioobjectOptional
documentobjectOptional
stickerobjectOptional
locationobjectOptional
contactslist of objectsOptional
interactiveobjectOptional
templateobjectOptional

Dynamic values for sending a template. carousel and buttons cannot coexist at the root.

Response

Message accepted by the provider.
message_idstring

Message identifier in Meta (wamid.xxx).

statusstring
Indicates that Meta accepted the send request.

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error