Use this section to send different WhatsApp message types.

Common request body

All send-message examples use the same top-level shape:
{
  "channel_id": "wzp_abc123",
  "to": "6281234567890",
  "type": "text",
  "content": {}
}
  • Use to for the recipient phone number in international format.
  • to_phone is accepted as an alias for to, but to is preferred.
  • content changes based on the selected type.
  • For media payloads, prefer media_url even though older aliases like media and url are still accepted.

Send text

Send plain text notifications and updates.

Send buttons

Send quick-reply button messages.

Send list

Send interactive list options.

Send image

Send image media with optional caption.

Send video

Send video media with optional caption.

Send audio

Send audio media URL.

Send document

Send document file and file name.

Send sticker

Send WhatsApp sticker by sticker URL.

Send location

Send a location pin with latitude and longitude.

Request user location

Ask user to share their location.

Send contact

Share contact information in chat.

Send reaction

React to a specific message.

Mark messages as read

Mark a message as read on provider side.

Send template

Send approved template-based messages.

Channel availability

Message typeOfficialUnofficial
TextYesYes
ButtonsYesYes (fallback text possible)
ListYesYes (fallback text possible)
Image / Video / Audio / DocumentYesYes
StickerYesYes
LocationYesYes
Request user locationYesYes
ContactYesYes
ReactionYesYes
Mark as readYesYes
TemplateYesYes (fallback text possible)
For full matrix, see Channel support.

Need exact fields?