Send a poll message

Sends a WhatsApp poll with a question and between 2 and 12 options through the authenticated WUTS device session. When allow_multiple_answers is true, recipients may select every option; otherwise the poll is single-choice. WUTS generates the poll message secret automatically.

Authorization

bearerAuth

AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

to*string

Recipient phone number or JID.

question*string

Poll question. Between 1 and 500 characters.

options*array<>

Poll options. Between 2 and 12 options are required.

allow_multiple_answers?boolean

When true the recipient may select multiple options; otherwise the poll is single-choice.

Response Body

`application/json`

curl -X POST "https://example.com/send/poll" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "question": "Which delivery slot works best for you?",    "options": [      {        "option_name": "Morning (8h-12h)"      },      {        "option_name": "Afternoon (12h-18h)"      },      {        "option_name": "Evening (18h-21h)"      }    ],    "allow_multiple_answers": false  }'

{  "success": true,  "message_id": "3EB0XXXXFFEEDDCCBBAA9988",  "timestamp": "2026-06-15T14:37:18Z",  "message": "Poll sent successfully",  "options_count": 3,  "multiple_choice": false}

{  "error": "Poll must have between 2 and 12 options"}

{  "error": "unauthorized"}

{  "error": "Failed to send poll: timeout"}

Send a poll message

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`