WhatsApp
Get call permission
Check whether a contact can be asked to call, or already allowed WhatsApp calls
GET
Returns the current WhatsApp calling permission for one sender and one customer phone number. Use this before you ask or place a call.
Rate-limited to 20 requests per minute per user.
Query Parameters
integer
required
WhatsApp sender ID from Get Senders
string
required
Customer phone number in E.164 format (e.g.
+40711222333)Response Fields
boolean
Request succeeded
integer
The sender you queried
string
Normalized E.164 phone number
string
Conversation UUID if a chat already exists, otherwise
nullstring
pending, granted, rejected, revoked, expired, or null if never askedboolean
true only when consent is granted and still validboolean
true when the 24-hour chat window is open and WhatsApp still allows another askboolean
true when the customer messaged this sender in the last 24 hoursstring
When granted consent ends (ISO 8601), or
nullstring
When the last ask was sent (ISO 8601), or
nullNotes
- Only senders that belong to your account are visible. A missing or foreign
sender_idreturnsSENDER_NOT_FOUND. can_requestisfalsewhen the chat window is closed — send a regular template and wait for a reply first. See WhatsApp Calling.can_requestandcan_callare alsofalsewhen the sender’s country does not allow business-initiated WhatsApp calls (United States, Canada, Egypt, Vietnam, Nigeria, Türkiye). Inbound calls still work.

