Skip to main content
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, plus success.

Error codes

  1. Send a regular template if there is no open chat
  2. Wait for the customer to reply (or poll session status)
  3. Call this endpoint
  4. Listen for call_permission_granted on the voice webhook
  5. Place the call
See WhatsApp Calling for the product rules behind these errors.