POST
/
message
/
sendList
/
{instance}
curl --request POST \
  --url https://{server-url}/message/sendList/{instance} \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '{
  "number": "<string>",
  "title": "<string>",
  "description": "<string>",
  "buttonText": "<string>",
  "footerText": "<string>",
  "sections": [
    {
      "title": "<string>",
      "rows": [
        {
          "title": "<string>",
          "description": "<string>",
          "rowId": "<string>"
        }
      ]
    }
  ],
  "delay": 123,
  "quoted": {
    "key": {
      "remoteJid": "<string>",
      "fromMe": true,
      "id": "<string>",
      "participant": "<string>"
    },
    "message": {
      "conversation": "<string>"
    }
  },
  "mentionsEveryOne": true,
  "mentioned": [
    "<string>"
  ]
}'
{
  "key": {
    "remoteJid": "553198296801@s.whatsapp.net",
    "fromMe": true,
    "id": "BAE5096096C5E261"
  },
  "message": {
    "listMessage": {
      "title": "List Title",
      "description": "List description",
      "buttonText": "Click Me",
      "listType": "PRODUCT_LIST",
      "sections": [
        {
          "title": "Section title",
          "rows": [
            {
              "title": "Row 1",
              "description": "Row 1 description",
              "rowId": "1"
            },
            {
              "title": "Row 2",
              "description": "Row 2 description",
              "rowId": "2"
            }
          ]
        },
        {
          "title": "Section 2",
          "rows": [
            {
              "title": "Row 1",
              "description": "Row 1 description",
              "rowId": "1"
            },
            {
              "title": "Row 2",
              "description": "Row 2 description",
              "rowId": "2"
            }
          ]
        }
      ],
      "contextInfo": {}
    }
  },
  "messageTimestamp": "1717782429",
  "status": "PENDING"
}

Authorizations

​
apikey
string
header
required

Your authorization key header

Path Parameters

​
instance
string
required

ID of the instance to connect

Body

application/json
​
number
string
required

Number to receive the message (with country code)

​
title
string
required

List title

​
buttonText
string
required

Button text

​
sections
object[]
required
​
description
string

List description

​
footerText
string

Footer text

​
delay
integer

Presence time in milliseconds before sending message

​
quoted
object
​
mentionsEveryOne
boolean

Mention everyone on a group message

​
mentioned
string[]

Response

201 - application/json
Created
​
message
object
required

The message content, which may include various types of messages like text, images, list, etc.

​
key
object

The key of the message, which identifies the message in the chat.

​
messageTimestamp
string

The timestamp of the message, represented as a string.

​
status
string

The status of the message, such as sent, received, or pending.

Send PollSend Buttons