Page Messenger Call Permissions

Version

20.0.021.0.022.0.023.0.024.0.025.0.026.0.0

Copy for LLM

View as Markdown

Download OpenAPI spec

Retrieve call permissions for a Messenger Business Platform page and a page-scoped user.

Base URL

| | | | https://graph.facebook.com/v26.0 |

Endpoints

| | | | GET | /{page_id}/messenger_call_permissions |

---

GET /{page_id}/messenger_call_permissions

Request Syntax

GET /{page_id}/messenger_call_permissions

Try it

Select language

cURLJavaScriptPython

---

curl --request GET \  
  --url 'https://graph.facebook.com/v26.0/{page_id}/messenger_call_permissions' \  
  --header 'Authorization: Bearer <Token>' \  
  --header 'Content-Type: application/json' \  
  --data '{}'

Path Parameters

---

page_idstring·required

The page ID for the messenger call permissions check

Query Parameters

---

psidstring·required

Page-scoped ID of the user to check permissions for

Responses

---

200

Retrieve messenger call permissions

Content Type: application/json

Schema: PageMessengerCallPermissionsResponse

Show child attributes

---

PageMessengerCallPermissionsResponse

---

dataarray of PageMessengerCallPermissionsPayload·required

Array containing call permissions data (Graph API edge format)

Show child attributes

---

data[]PageMessengerCallPermissionsPayload

Show child attributes

---

permissionobject·required

Permission status for business-initiated calls

Show child attributes

---

statusOne of "HAS_PERMISSION", "NO_PERMISSION"·required

Permission status (HAS_PERMISSION or NO_PERMISSION)

---

expiration_timeinteger

Unix timestamp when permission expires (only present if HAS_PERMISSION)

---

actionsarray of object

Available actions and their constraints

Show child attributes

---

actions[]object

Show child attributes

---

action_nameOne of "send_call_permission_request", "start_call"·required

Name of the action (send_call_permission_request or start_call)

---

can_performboolean·required

Whether the action can be performed

---

limitsarray of object

Rate limit information for the action

Show child attributes

---

limits[]object

Show child attributes

---

time_periodstring·required

Time period for the limit (e.g., PT24H)

---

max_allowedinteger·required

Maximum allowed requests in the time period

---

current_usageinteger·required

Current usage count in the time period

400

Bad request

Content Type: application/json

Schema: StandardError

Show child attributes

---

StandardError

---

messagestring·required

---

typestring

---

codeinteger·required

---

error_subcodeinteger

---

is_transientboolean

---

error_data{}

---

error_user_msgstring

---

error_user_titlestring

---

fbtrace_idstring

403

Forbidden

Content Type: application/json

Schema: StandardError

Show child attributes

---

StandardError

---

messagestring·required

---

typestring

---

codeinteger·required

---

error_subcodeinteger

---

is_transientboolean

---

error_data{}

---

error_user_msgstring

---

error_user_titlestring

---

fbtrace_idstring

Select language

cURLJavaScriptPython

---

curl --request GET \  
  --url 'https://graph.facebook.com/v26.0/{page_id}/messenger_call_permissions' \  
  --header 'Authorization: Bearer <Token>' \  
  --header 'Content-Type: application/json' \  
  --data '{}'

Authentication

| | | | Scheme | Type | Location | | OAuthToken__access_token | API Key | Query: access_token | | OAuthToken__oauth_token | API Key | Query: oauth_token | | OAuthToken__Authorization | HTTP Bearer | Header: Authorization |

Usage Examples

OAuthToken__access_token:

Include access_token=your-api-key-here in query parameters

OAuthToken__oauth_token:

Include oauth_token=your-api-key-here in query parameters

OAuthToken__Authorization:

Include Authorization: Bearer your-token-here in request headers

Global Authentication Requirements

All endpoints require:

OAuthToken__access_token AND OAuthToken__oauth_token AND OAuthToken__Authorization