Manage a call

Developing

POST

/v1/whatsapp/{whatsappApiVersion}/{whatsappPhoneNumberId}/calls

Pass-through for Meta's POST /{PHONE_NUMBER_ID}/calls endpoint.

Use the action field to perform call operations:

Action	Description
`connect`	Initiate an outbound call (business-initiated)
`pre_accept`	Pre-accept an inbound call (establish media path early)
`accept`	Accept an inbound call
`reject`	Reject an inbound call
`terminate`	Terminate an active call

Note: When SIP is enabled on the phone number, Graph API call endpoints are
unavailable — use SIP signaling instead.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Call action completed successfully.

Bodyapplication/json

🟢200MetaError

🟠400ChakraBadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/whatsapp///calls' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "messaging_product": "whatsapp",
    "to": "919901258433",
    "action": "connect",
    "session": {
        "sdp_type": "offer",
        "sdp": "v=0\\r\\no=- 0 0 IN IP4 127.0.0.1\\r\\n..."
    },
    "biz_opaque_callback_data": "my-tracking-id"
}'

Response Example

200 - Outbound call initiated

{
    "messaging_product": "whatsapp",
    "calls": [
        {
            "id": "wacid.ABGGFjFVU2AfAgo6V"
        }
    ]
}

Modified at 2026-07-01 11:58:59

Get call permission state

Create Connect Token