WhatsApp Gateway
API referenceMessages

Vote on a poll message

POST
/api/v1/sessions/{session}/messages/{mid}/vote

Replace your poll vote.

Use options for the full set of selected choices. Send empty list to clear vote.

Returns 200 with a SendResult.

Errors: validation_error for bad poll/options and not_found for missing message or session.

Authorization

AuthorizationBearer <token>

Send Authorization: Bearer <token>. The token can be a login JWT from the frontend or an api-key for a script. JWT access comes from the person's organization role. Api-key access comes from the permissions saved on the key.

In: header

Path Parameters

session*string

WhatsApp session id casting the vote. Must be owned and connected.

Example"01HZX..."
mid*string

WhatsApp message id of the poll.

Example"3EB0C431C26A1916E07A"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

chat?string

Chat JID of the poll.

Example"120363012345678901@g.us"
options?array<string>|

Complete list of selected options. Send empty list to clear vote.

Example

[  "Pizza",  "Sushi"]
sender?string

Poll sender JID.

Example""

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/sessions/01HZX.../messages/3EB0C431C26A1916E07A/vote" \  -H "Content-Type: application/json" \  -d '{}'
{  "mode": "string",  "outboxId": "string",  "replayed": true,  "status": "string",  "timestamp": 0,  "waMessageId": "string"}
{  "error": {    "code": "not_found",    "details": {      "property1": null,      "property2": null    },    "message": "session not found"  }}