Send poll - Wawp WhatsApp API

POST /sendPoll

Sends an interactive poll message to a chat or group.
Polls allow recipients to vote on one or multiple options. This endpoint is essential for gathering feedback, scheduling (e.g., voting on meeting times), or simple engagement within groups.

Developer Tips & Best Practices:

Optimistic UI: Display the poll immediately in your chat UI as "sending" while waiting for the API response.

Validation: Ensure you provide at least two options and no more than 12 options (WhatsApp limit). Check that option names are not empty before sending to avoid 400 Bad Request errors.

Group vs. Private: Polls work in both private chats and groups. In groups, user votes are visible to everyone by default.

Vote Updates: This API sends the poll creation message. To track votes in real-time, you must configure a Webhook to listen for poll.vote events.

Error Handling: If you receive a wawp_upstream_error (e.g., due to rate limits or invalid JIDs), allow the user to retry sending the poll via a UI button rather than auto-retrying immediately.

{ "instance_id": "123456789", "access_token": "123456789", "chatId": "447441429009@c.us", "poll": { "name": "How are you?", "options": [ "Awesome!", "Good!", "Not bad!" ], "multipleAnswers": false } }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Success

application/json

Body

Example

{
    "id": "true_1234567890@c.us_AAAAAAAAAAAAAAAAAAAAAA",
    "_data": {
        "Info": {
            "Chat": "1234567890@s.whatsapp.net",
            "Sender": "1234567890:13@s.whatsapp.net",
            "IsFromMe": true,
            "IsGroup": false,
            "AddressingMode": "",
            "SenderAlt": "",
            "RecipientAlt": "",
            "BroadcastListOwner": "",
            "BroadcastRecipients": null,
            "ID": "AAAAAAAAAAAAAAAAAAAAAA",
            "ServerID": 0,
            "Type": "",
            "PushName": "",
            "Timestamp": "2026-01-03T00:32:24Z",
            "Category": "",
            "Multicast": false,
            "MediaType": "",
            "Edit": "",
            "MsgBotInfo": {
                "EditType": "",
                "EditTargetID": "",
                "EditSenderTimestampMS": "0001-01-01T00:00:00Z"
            },
            "MsgMetaInfo": {
                "TargetID": "",
                "TargetSender": "",
                "TargetChat": "",
                "DeprecatedLIDSession": null,
                "ThreadMessageID": "",
                "ThreadMessageSenderJID": ""
            },
            "VerifiedName": null,
            "DeviceSentMeta": null
        },
        "Message": {
            "messageContextInfo": {
                "messageSecret": "REDACTED_SECRET_KEY"
            },
            "pollCreationMessageV3": {
                "name": "How are you?",
                "options": [
                    {
                        "optionName": "Awesome!"
                    },
                    {
                        "optionName": "Good!"
                    },
                    {
                        "optionName": "Not bad!"
                    }
                ],
                "selectableOptionsCount": 1,
                "pollContentType": 1
            }
        },
        "IsEphemeral": false,
        "IsViewOnce": false,
        "IsViewOnceV2": false,
        "IsViewOnceV2Extension": false,
        "IsDocumentWithCaption": false,
        "IsLottieSticker": false,
        "IsBotInvoke": false,
        "IsEdit": false,
        "SourceWebMsg": null,
        "UnavailableRequestID": "",
        "RetryCount": 0,
        "NewsletterMeta": null,
        "RawMessage": {
            "messageContextInfo": {
                "messageSecret": "REDACTED_SECRET_KEY"
            },
            "pollCreationMessageV3": {
                "name": "How are you?",
                "options": [
                    {
                        "optionName": "Awesome!"
                    },
                    {
                        "optionName": "Good!"
                    },
                    {
                        "optionName": "Not bad!"
                    }
                ],
                "selectableOptionsCount": 1,
                "pollContentType": 1
            }
        }
    }
}