Appearance
Page Calls
Version
20.0.021.0.022.0.023.0.024.0.025.0.026.0.0
Copy for LLM
Handle call actions for Messenger Business Platform pages.
Base URL
| | | | https://graph.facebook.com/v26.0 |
Endpoints
| | | | POST | /{page_id}/calls |
POST /{page_id}/calls
Request Syntax
POST /{page_id}/calls
Try it
Select language
cURLJavaScriptPython
curl --request POST \
--url 'https://graph.facebook.com/v26.0/{page_id}/calls' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data '{}'Path Parameters
page_idstring·required
The page ID for the messenger call
Request BodyRequired
Content Type: application/json
Schema: PageCallsRequest
Show child attributes
PageCallsRequest
platformOne of "instagram", "messenger", "whatsapp"
Platform for the messaging service
call_idstring
Unique identifier for the call
actionOne of "accept", "connect", "media_update", "reject", "terminate"·required
The call action to perform (accept, connect, terminate, etc.)
tostring
Target user for the call
sessionobject
Session payload with SDP information
Show child attributes
sdp_typestring·required
Type of SDP (Session Description Protocol)
sdpstring·required
Session Description Protocol data
tracksarray of object
Media track configurations (max 4 items)
Show child attributes
tracks[]object
Show child attributes
msidstring·required
Media stream identifier
labelOne of "default_audio", "default_video", "screen_audio", "screen_video"·required
Media track label type
statusOne of "disabled", "enabled"·required
Media track status
from_versioninteger
Current version number of the peer connection
to_versioninteger
New version number of the peer connection
Responses
200
Response containing the result of the call action and session information
Content Type: application/json
Schema: PageCallsResponse
Show child attributes
PageCallsResponse
successboolean·required
Indicates if the call action was processed successfully
call_idstring
Unique identifier for the call conference
sessionobject
Session data containing SDP information
Show child attributes
sdp_responseobject·required
SDP response data
Show child attributes
sdpstring·required
Session Description Protocol data
sdp_typestring·required
Type of SDP (Session Description Protocol)
sdp_renegotiationobject
SDP renegotiation data for call updates
Show child attributes
sdpstring·required
Renegotiation Session Description Protocol data
sdp_typestring·required
Type of renegotiation SDP (Session Description Protocol)
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 POST \
--url 'https://graph.facebook.com/v26.0/{page_id}/calls' \
--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