Call Permissions

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.

get/{Version}/{Phone-Number-ID}/call_permissions

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/call_permissions
  • Auth
    HTTP bearer

Query parameters

user_wa_idstring required
Example:14085551234

The WhatsApp ID of the user you want to check call permissions for

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Response

Call Permissions Check Success

messaging_productstring required

Messaging product

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.