Pollsv4

Send a poll

POST/chats/{chatId}/polls

Sends a native iMessage poll to a chat. Requires a title and 2+ options. Blooio channels only.

Path parameters

chatIdRequiredstring

Unique identifier of the chat, prefixed with chat_. Returned by the List chats endpoint.

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

titleRequiredstring

optionsRequiredstring[]

Returns

dataoptionalPoll

idoptionalstring

chat_idoptionalstring

channel_idoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

typeoptionalstring

"poll"

statusoptionalstring

polloptionalobject

titleoptionalstring

optionsoptionalstring[]

Response codes

201Poll queued

401Your API key is missing or invalid. Pass it as a bearer token.

404No poll was found with the provided `chatId`.

409The request conflicts with the current state of the poll (e.g. it already exists, the chat is closed, or the channel isn't active).

422Validation failed — one or more fields in the request are invalid or missing.

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/v4/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

{  "data": {    "id": "poll_a1b2c3d4",    "chat_id": "chat_a1b2c3d4",    "channel_id": "ch_a1b2c3d4",    "channel_type": "blooio",    "type": "poll",    "status": "active",    "poll": {      "title": "Example title",      "options": [        "string"      ]    }  }}