Check Call Permissions
Check whether you have permission to call a WhatsApp user and what actions are available. This endpoint returns the current permission status for calling a specific user, along with available actions and their limits.
Permission Status:
- granted: You have active permission to call this user - pending: A permission request has been sent but not yet approved - denied: The user has denied call permissions - expired: Previous permission has expired
Available Actions:
- start_call: Initiate a new call to this user - send_call_permission_request: Send a permission request to this user
Error Handling: This endpoint may return various error codes including rate limiting errors if too many permission checks are made within a short period.
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Phone-Number-ID}/call_permissions
- AuthHTTP bearer
Query parameters
The WhatsApp ID of the user you want to check call permissions for
Headers
The user agent string identifying the client software making the request.
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Media type of the request body
Response
Call Permissions Check Success
Example response
{
"messaging_product": "whatsapp",
"permission": {
"status": "granted",
"expiration_time": 1735689600
},
"actions": [
{
"action_name": "start_call",
"can_perform_action": true,
"limits": [
{
"time_period": "24h",
"current_usage": 5,
"max_allowed": 100,
"limit_expiration_time": 1735689600
}
]
}
]
}Changes
No recorded changes to this operation across all 5 revisions of this API.