Send list

Show a scrollable menu when you have more options than buttons allow — support menus, product picks, or any flow with several choices.

At a glance

Item	Detail
`type`	`list`
Channel support	Official and unofficial
Unofficial	May be delivered as formatted fallback text
Structure	`sections[]` with `rows[]` (`id`, `title`, optional `description`)

Request body

Field	Required	Description
`channel_id`	Yes	Sender channel ID
`to`	Yes	Recipient phone number
`type`	Yes	`list`
`content.body`	Yes	Message text
`content.button_text`	Yes	Label on the list open button
`content.sections`	Yes	Array of sections with `title` and `rows`

Example

curl -X POST "https://api.wazapin.com/v1/messages" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "wzp_abc123",
    "to": "6281234567890",
    "type": "list",
    "content": {
      "body": "Pilih menu yang kamu mau",
      "button_text": "Lihat menu",
      "sections": [
        {
          "title": "Menu utama",
          "rows": [
            {"id": "menu_1", "title": "Cek pesanan", "description": "Lihat status order"},
            {"id": "menu_2", "title": "Hubungi CS", "description": "Butuh bantuan"}
          ]
        }
      ]
    }
  }'

import { WazapinClient, listMessage } from "@wazapin/sdk";

const wazapin = new WazapinClient({ apiKey: process.env.WAZAPIN_API_KEY! });

await wazapin.messages.send(
  listMessage({
    channel_id: "wzp_abc123",
    to: "6281234567890",
    body: "Pilih menu yang kamu mau",
    button: "Lihat menu",
    sections: [
      {
        title: "Menu utama",
        rows: [
          { id: "menu_1", title: "Cek pesanan", description: "Lihat status order" },
          { id: "menu_2", title: "Hubungi CS", description: "Butuh bantuan" },
        ],
      },
    ],
  }),
);

import requests

requests.post(
    "https://api.wazapin.com/v1/messages",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "channel_id": "wzp_abc123",
        "to": "6281234567890",
        "type": "list",
        "content": {
            "body": "Pilih menu yang kamu mau",
            "button_text": "Lihat menu",
            "sections": [
                {
                    "title": "Menu utama",
                    "rows": [
                        {"id": "menu_1", "title": "Cek pesanan", "description": "Lihat status order"},
                        {"id": "menu_2", "title": "Hubungi CS", "description": "Butuh bantuan"},
                    ],
                }
            ],
        },
    },
    timeout=30,
).raise_for_status()

When the user replies, see Handle inbound text or Handle interactive replies.

Endpoint

POST https://api.wazapin.com/v1/messages Authenticate with X-Api-Key. See Authentication.

Response

On success, the API returns 201 Created with a message record (status often starts as queued).

201 Created

{
  "data": {
    "id": "9f1fd66d-c37a-4b50-a8c2-b4dca523f9c8",
    "channel_id": "wzp_abc123",
    "to_phone": "6281234567890",
    "type": "text",
    "status": "queued",
    "created_at": "2026-03-04T06:20:10Z",
    "updated_at": "2026-03-04T06:20:10Z"
  }
}

Track delivery with Webhooks or GET /v1/messages/.

Get started

WhatsApp concepts

Send messages

Receive messages

Templates

AI & MCP

SDKs

Tools

Platform

Examples

Updates

At a glance

Request body

Example

Endpoint

Response

​At a glance

​Request body

​Example

​Endpoint

​Response

​Related

At a glance

Request body

Example

Endpoint

Response

Related