WhatsApp
Request call permission
Send a WhatsApp Voice Call Request (Ask to call) to a customer
POST
Sends the sender’s approved Voice Call Request template so the customer can Allow or Decline WhatsApp calls.
This endpoint will not send the request if the 24-hour chat window is closed. That protects your WhatsApp quota: a request sent to a brand-new number is not delivered, but still counts as your one ask for the day.
Rate-limited to 5 requests per minute, 20 per hour, and 50 per day per user. WhatsApp typically allows 1 ask per contact every 24 hours and 2 per week. Those WhatsApp counters reset after a connected call.
Request Body
integer
required
WhatsApp sender ID. Calling must already be enabled on this sender.
string
required
Customer phone number in E.164 format
string
Optional display name for the conversation (max 255 characters)
integer
Optional Voice Call Request template ID. If omitted, the sender’s approved voice-call template is used.
Response Fields
Same shape as Get call permission, plussuccess.
Error codes
Recommended flow
- Send a regular template if there is no open chat
- Wait for the customer to reply (or poll session status)
- Call this endpoint
- Listen for
call_permission_grantedon the voice webhook - Place the call

