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": {}
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/EvolutionAPI/evolution-api/llms.txt

Use this file to discover all available pages before exploring further.

​
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.