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

# Send Poll

`POST /message/sendPoll/{instance}`

Send Poll

## Path parameters

- `instance` string, required

## Request body

- object
  - `number` string, required — {{remoteJid}}
  - `name` string, required — Main text of the poll
  - `selectableCount` number, required — Ex: 1
  - `values` string[], required — Values for question
  - `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.

---

[API](https://skmtc.net/evolution-foundation/apis/evolution-api-2.md) · [All operations](https://skmtc.net/evolution-foundation/apis/evolution-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/evolution-foundation/evolution-api-2/revisions/153363ee7f38/schema)