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.
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 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.
Response Body
application/json
application/json
application/json
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"}Pin or unpin a message in a chat POST
Pins or unpins a message in a one-to-one or group chat. Set `messageAction` to `pin` or `unpin` and pass the `messageId` of the target message. For `pin`, `pinMessageDuration` selects how long the message stays pinned (`24_hours`, `7_days`, or `30_days`). WUTS automatically detects whether the target message was sent by this account or received from the contact/participant, so the pinned-message banner resolves correctly on the recipient's device — you can override this with the optional `fromMe` and `participant` fields. Alias: `phone` for `to`.
Send a product message POST
Sends a single catalog product card to a WhatsApp recipient through WUTS. The product snapshot (id and title required) is enriched with optional price, currency, description, and image (base64 or remote URL, which WUTS uploads to WhatsApp media).