Pollsv2

Send a poll

POST/chats/{chatId}/polls

Send a native iMessage poll to a chat. The poll appears as an interactive ballot that recipients can vote on.

Path parameters

chatIdRequiredstring

Chat identifier. Can be: (1) phone number in E.164 format (e.g., +15551234567), (2) email address, (3) group ID (grp_xxxx), or (4) comma-separated list of phone numbers/emails for multi-recipient group chats (e.g., +15551234567,+15559876543). All values should be URL-encoded.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON

titleoptionalstring

Poll question or title (optional)

optionsRequiredstring[]

Array of 2-10 option strings for the poll

Returns

poll_idoptionalstring

Unique identifier for the poll

chat_idoptionalstring

polloptionalobject

titleoptionalstring

optionsoptionalstring[]

sent_atoptionalnumber

Response codes

200Poll sent successfully

400Invalid request parameters

401Authentication required or invalid

502Device unreachable

503No active device available

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X POST https://api.blooio.com/v2/api/chats/chat_a1b2c3d4/polls \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "title": "Example title",    "options": [      "string"    ]  }'

Body object

{  "title": "Example title",  "options": [    "string"  ]}

Response objectexample

{  "poll_id": "poll_a1b2c3d4",  "chat_id": "chat_a1b2c3d4",  "poll": {    "title": "Example title",    "options": [      "string"    ]  },  "sent_at": 0}