# WhatsApp Call Permissions API

**Canonical:** https://apis.io/apis/whatsapp/whatsapp-call-permissions-api/  
**Provider:** WhatsApp — https://apis.io/providers/whatsapp/  
**Base URL:** https://graph.facebook.com  
**Documentation:** https://developers.facebook.com/documentation/business-messaging/whatsapp/overview

WhatsApp Call Permissions API is one of 74 APIs that [WhatsApp](https://apis.io/providers/whatsapp/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Call Permissions. The published artifact set on APIs.io includes an OpenAPI specification, a GitHub repository, API documentation, and 6 JSON Schemas.

Use the **`/{Phone-Number-ID}/call_permissions`** endpoint to check whether you have permission to call a specific WhatsApp user and understand what calling-related actions are available. ## Prerequisites * [User Access Token](https://developers.facebook.com/docs/facebook-login/access-tokens#usertokens) with **`whatsapp_business_messaging`** permission * `phone-number-id` for your registered WhatsApp Business Account * WhatsApp Cloud API Calling must be enabled for your phone number ## Permission Status Types - **granted**: You have active permission to call this user - **pending**: A permission request has been sent but not yet approved by the user - **denied**: The user has denied call permissions for your business - **expired**: Previous permission has expired and needs to be renewed ## Available Actions - **start_call**: Initiate a new call to this user (available when permission is granted) - **send_call_permission_request**: Send a permission request to this user (available when permission is denied or expired) ## Rate Limiting This endpoint has specific rate limits to prevent abuse. Exceeding the rate limit will result in error code 4 with subcode 2390008. ## Error Handling - **403 Forbidden**: Calling is not enabled for your phone number - **429 Too Many Requests**: Rate limit exceeded for permission checks - **400 Bad Request**: Missing or invalid `user_wa_id` parameter

## Operations (1)

| Method | Path | Summary |
|---|---|---|
| GET | `/{Version}/{Phone-Number-ID}/call_permissions` | Check Call Permissions |

## Machine-readable artifacts (10)

- **OpenAPI** — https://artifacts.apis.io/whatsapp/openapi/whatsapp-call-permissions-api-openapi.yml
- **GitHubRepository** — https://github.com/meta/openapi
- **Documentation** — https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
- **PostmanCollection** — https://raw.githubusercontent.com/WhatsApp/WhatsApp-Flows-Tools/main/postman/v1/whatsapp-cloud-api.postman_collection.json
- **JSONSchema** — https://artifacts.apis.io/whatsapp/json-schema/whatsapp-call-request-payload-schema.json
- **JSONSchema** — https://artifacts.apis.io/whatsapp/json-schema/whatsapp-whats-app-business-account-schema.json
- **JSONSchema** — https://artifacts.apis.io/whatsapp/json-schema/whatsapp-whats-app-business-profile-node-schema.json
- **JSONSchema** — https://artifacts.apis.io/whatsapp/json-schema/whatsapp-phone-number-info-schema.json
- **JSONSchema** — https://artifacts.apis.io/whatsapp/json-schema/whatsapp-call-permission-check-response-payload-schema.json
- **JSONSchema** — https://artifacts.apis.io/whatsapp/json-schema/whatsapp-whats-app-account-number-schema.json

## Other WhatsApp APIs (12)

- [WhatsApp Flows API](https://apis.io/apis/whatsapp/flows-api/)
- [WhatsApp On-Premises API](https://apis.io/apis/whatsapp/on-premises-api/)
- [WhatsApp Analytics API](https://apis.io/apis/whatsapp/whatsapp-analytics-api/)
- [WhatsApp Assets API](https://apis.io/apis/whatsapp/whatsapp-assets-api/)
- [WhatsApp Assigned Users API](https://apis.io/apis/whatsapp/whatsapp-assigned-users-api/)
- [WhatsApp Business Accounts API](https://apis.io/apis/whatsapp/whatsapp-business-accounts-api/)
- [WhatsApp Business Profile API](https://apis.io/apis/whatsapp/whatsapp-business-profile-api/)
- [WhatsApp Lifecycle API](https://apis.io/apis/whatsapp/whatsapp-lifecycle-api/)
- [WhatsApp Media API](https://apis.io/apis/whatsapp/whatsapp-media-api/)
- [WhatsApp Message Templates API](https://apis.io/apis/whatsapp/whatsapp-message-templates-api/)
- [WhatsApp Messages API](https://apis.io/apis/whatsapp/whatsapp-messages-api/)
- [WhatsApp Phone Numbers API](https://apis.io/apis/whatsapp/whatsapp-phone-numbers-api/)

## Tags

Call Permissions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/whatsapp/whatsapp-call-permissions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/whatsapp/.