Skip to main content
POST
/
message
/
sendList
/
:instanceName
Send list
curl --request POST \
  --url https://api.example.com/message/sendList/:instanceName \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "<string>",
  "title": "<string>",
  "description": "<string>",
  "buttonText": "<string>",
  "footerText": "<string>",
  "sections": [
    {
      "title": "<string>",
      "rows": [
        {
          "title": "<string>",
          "description": "<string>",
          "rowId": "<string>"
        }
      ]
    }
  ],
  "delay": 123
}
'
{
  "key": {},
  "message": {}
}

Request

Send a message with an interactive list that users can open to see multiple options organized in sections.
instanceName
string
required
Name of the instance

Body parameters

number
string
required
Recipient’s WhatsApp number with country code (e.g., “5511999999999”)
title
string
required
Main title text of the message
description
string
Description text shown in the message body
buttonText
string
required
Text displayed on the button that opens the list
Footer text displayed at the bottom
sections
array
required
Array of section objects containing rows
delay
number
Delay in milliseconds before sending

Response

key
object
Message key information
message
object
List message details

Example request

curl -X POST https://your-api.com/message/sendList/my-instance \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999",
    "title": "Product Catalog",
    "description": "Choose a product category",
    "buttonText": "View Products",
    "footerText": "Evolution API Store",
    "sections": [
      {
        "title": "Electronics",
        "rows": [
          {
            "title": "Smartphone",
            "description": "Latest model smartphones",
            "rowId": "product-smartphone"
          },
          {
            "title": "Laptop",
            "description": "High-performance laptops",
            "rowId": "product-laptop"
          }
        ]
      },
      {
        "title": "Accessories",
        "rows": [
          {
            "title": "Headphones",
            "description": "Wireless and wired options",
            "rowId": "product-headphones"
          }
        ]
      }
    ]
  }'

Notes

  • List messages can contain multiple sections
  • Each section can have multiple rows (up to 10 rows per section recommended)
  • Use the rowId to identify which option was selected in webhook events
  • The list appears as a menu when the user taps the button
Lists are ideal for:
  • Product catalogs
  • Service menus
  • FAQ categories
  • Navigation menus
List messages are only supported on WhatsApp versions that support interactive messages. Older clients may not render the list properly.

Build docs developers (and LLMs) love