Skip to main content
POST
Send poll

Authorizations

Authorization
string
header
required

Instance token (zpfy_inst_...) — sends messages.

Body

application/json
to
string
required

Message recipient: phone in E.164 (e.g. 5511999998888) or a group id.

Example:

"5511999998888"

question
string
required

Poll question.

Example:

"Pizza?"

options
string[]
required

Answer options (minimum 2).

Minimum array length: 2
Example:
maxAnswer
integer

Max options the user can pick.

Required range: x >= 1
delay
integer

Optional delay in milliseconds before sending; WhatsApp shows "typing…" during this interval.

quoted
object

Quotes (replies to) a previous message.

Response

Message accepted by WhatsApp.

data
object

Identifier of the sent message. Store the messageId: together with the same to you sent to, it is what /messages/delete and /messages/edit need.