Skip to main content
POST
Send a poll
Send a native iMessage poll. On iOS 26 and later it lands as tappable choices. Older iPhones show the fallback “Sent a poll”. Polls are iMessage-only. SMS is rejected. Scope: comms_send

Request

Body parameters

string
E.164 destination. Required unless conversation_id or contact_id is set.
string
Existing conversation to continue. Required unless to or contact_id is set.
string
Existing contact. Required unless to or conversation_id is set.
string
required
Poll question. Max 200 characters.
string[]
required
Two to twelve distinct choices. Each option is at most 80 characters.
string
ISO country code used only when to is a national-format number.

Response

Same envelope as Send a message, plus poll.
Hosted Comms agents can also send this with the send_poll tool. When a contact votes, Comms records an inbound message such as Voted "Pizza" on "Lunch?" and emits comms.poll.voted. A native tap vote includes the chosen option when the line receives the vote payload; a text reply that matches an option or its number is treated the same way.