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
​
footerText
string
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

Get started for freeTalk to us