Skip to main content
POST
/
{instance}
/
send-poll
curl --request POST \
  --url https://app.hypersender.com/api/whatsapp/v2/{instance}/send-poll \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chatId": "[email protected]",
  "reply_to": "string",
  "poll": {
    "name": "How are you?",
    "options": [
      "Awesome!",
      "Good!",
      "Not bad!"
    ],
    "multipleAnswers": true
  }
}
'
{
  "id": "[email protected]_3EB0A4F993D38D3BBD04F3",
  "timestamp": 1741448369,
  "from": "[email protected]",
  "fromMe": true,
  "body": null,
  "hasMedia": false,
  "media": null,
  "ack": 0,
  "ackName": "PENDING",
  "replyTo": null,
  "_data": {
    "key": {
      "remoteJid": "[email protected]",
      "fromMe": true,
      "id": "3EB0A4F993D38D3BBD04F3"
    },
    "message": {
      "messageContextInfo": {
        "messageSecret": "VrTaj/wh+/lyIUdBi8TV4JCpbNK1Dd54SNZHH8vR2x0="
      },
      "pollCreationMessageV3": {
        "name": "Sample Poll",
        "options": [
          {
            "optionName": "Option 1"
          },
          {
            "optionName": "Option 2"
          },
          {
            "optionName": "Option 3"
          }
        ],
        "selectableOptionsCount": 1
      }
    },
    "messageTimestamp": 1741448369,
    "status": "PENDING"
  }
}
V2 Queued Response: All API requests in V2 are queued for improved reliability. You’ll receive an immediate response with a queued_request_uuid that you can use to check the actual message status.

​
Response Format

All requests return a queued response: 
{
    "queued": true,
    "message": "Processing your request...",
    "queued_request_uuid": "a0816120-7e37-4e8b-8cf3-92deb2cdc133",
    "queued_request_link": "https://app.hypersender.com/api/whatsapp/v2/{instance}/queued-requests/a0816120-7e37-4e8b-8cf3-92deb2cdc133"
}
Use the queued_request_link or the Get Queued Request endpoint to check the actual message response once it’s processed. More details on queued requests can be found in the Queued Requests Documentation.
You can create a poll in a chat.
Send Poll Example

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept
string
Example:

"application/json"

​
Content-Type
string
Example:

"application/json"

Path Parameters

​
instance
string
required
Example:

"{{ instance_id }}"

Body

application/json
​
chatId
string
required
​
poll
object
required
​
reply_to
string

Response

Successful response

​
id
string
​
timestamp
number
​
from
string
​
fromMe
boolean
​
body
string
​
hasMedia
boolean
​
media
object
​
ack
number
​
ackName
string
​
replyTo
string
​
_data
object