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.

Headers

• field string (required) — Your workspace API key. Create one in the dashboard.

• field string (required) — Set to application/json.

Request body

• channel_id string (required) — The ID of the WhatsApp channel sending the message.

• to string (required) — Recipient phone number in international format (without the leading +).

• type string (required) — The type of message being sent (e.g. text, image, template, buttons, list).

• content object (required) — 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

• Channel support matrix
• Reference: get message
• Message lifecycle & idempotency