---
title: "Send List"
method: POST
path: "/message/sendList/{instance}"
tags: ["Message Controller"]
---

# Send List

`POST /message/sendList/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/message/sendList/{instance}`
- Auth: API key in header `apikey`

Send List

## Path parameters

- `instance` string, required

## Request body

- object
  - `number` string, required: {{remoteJid}}
  - `title` string, required: Title of list
  - `description` string, required: Description for lists
  - `buttonText` string, required: Text Button
  - `footerText` string, required: footer list https://examplelink.com.br
  - `values` object[], required
    - `title` string: title item of list
    - `rows` object[]
      - `title` string: Title of row
      - `description` string: Description of row
      - `rowId` string: Id of row
  - `delay` integer: Presence time in milliseconds before sending message
  - `linkPreview` boolean: Shows a preview of the target website if there's a link within the message
  - `mentionsEveryOne` boolean: Mentioned everyone when the message send
  - `mentioned` string[]: Numbers to mention
  - `quoted` object
    - `key` object
      - `id` string: Quoted message ID
    - `message` object
      - `conversation` string: Quoted message content

## Response `201`

Created

- object
  - `key` object: The key of the message, which identifies the message in the chat.
    - `remoteJid` string: The remote Jid.
    - `fromMe` boolean: Indicates whether the message was sent by the user.
    - `id` string: The ID of the message.
  - `message` object: The message content, which may include various types of messages like text, images, poll creation, etc.
    - `messageContextInfo` object: Information about the context of the message.
      - `messageSecret` string: The secret of the message context.
    - `pollCreationMessage` object: Details of the poll creation message.
      - `name` string: The name of the poll.
      - `options` object[]: The options available in the poll.
        - `optionName` string: The name of the poll option.
      - `selectableOptionsCount` integer: The number of options that can be selected in the poll.
  - `messageTimestamp` string: The timestamp of the message, represented as a string.
  - `status` string: The status of the message, such as sent, received, or pending.

## Changes

- **2024-11-25** (v2) `00ad9123c5ee`: 1 info
  - endpoint added
- **2024-11-25** (v2) `3da4e104d42b`: 1 breaking
  - api path removed without deprecation
- **2024-11-25** (v2) `c153448703e5`: 1 breaking, 8 info
  - removed the success response with the status `200`
  - api operation id `sendList` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Message Controller` added
  - …5 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 1 breaking, 10 warning, 5 info
  - removed the success response with the status `201`
  - removed the request property `buttonText`
  - removed the request property `delay`
  - removed the request property `description`
  - …12 more
- **2024-08-09** (v2) `996acfdb07ce`: 4 breaking, 2 warning, 6 info
  - added the new required request property `buttonText`
  - added the new required request property `sections`
  - added the new required request property `title`
  - the request property `number` became required
  - …8 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/message/sendList/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)