Request guides
Reference: send message
Endpoint reference and index of guides for sending all types of WhatsApp messages.
POST
Reference: send message
Use this endpoint to send WhatsApp messages to customers. The payload shape in the
content block changes depending on the message type you choose.
For the complete, interactive field reference and API playground, see the canonical Send a message API reference.
Headers
Set to
application/json.Request body
The ID of the WhatsApp channel sending the message.
Recipient phone number in international format (without the leading
+).The type of message being sent (e.g.
text, image, template, buttons, list).The payload structure specific to the chosen
type.Message type guides
Select a guide below to view detailed specifications, parameters, and code examples for each message type:Interactive & templates
- Send templates: Pre-approved notifications (order updates, OTPs).
- Send text: Plain text messages and conversation replies.
- Send buttons: Quick-reply buttons.
- Send list: Interactive picker menus.
Media attachments
- Send image: JPG/PNG photos with optional captions.
- Send video: MP4 video attachments.
- Send audio: Audio files and voice notes.
- Send document: PDF and other documents.
- Send sticker: static or animated WebP stickers.
Location & contacts
- Send location: Geographic coordinates (latitude/longitude) with pin.
- Request location: Ask the customer to share their location coordinates.
- Send contact: Share contact card information.
Actions
- Send reaction: Add an emoji reaction to a message.
- Mark read: Mark inbound messages as read.
Related pages
Reference: send message