Messenger Platform
Reject or end a call
Updated: Mar 23, 2026
You can reject an incoming call before accepting it, or terminate an active call that is already connected.
Before you begin
- Complete the setup described in the Calling overview
Reject an incoming call
Request syntax
POST /{page-id}/calls { "platform": "messenger", "call_id": "{call-id}", "action": "reject" }
Request parameters
| Property | Description |
|---|---|
platform Optional string | Only Messenger is supported |
call_id string | ID of the call from the connect webhook |
action string | Set to reject |
Example response
{ "success" : true }
Error response
The following errors can occur:
- Invalid call ID or Page ID
- Call already rejected
- Cannot reject a failed or completed call
- Permissions or authorization errors
For more details, see the Messenger Platform error codes reference.
Terminate an active call
Request syntax
POST /{page-id}/calls { "platform": "messenger", "call_id": "{call-id}", "action" : "terminate" }
Request parameters
| Property | Description |
|---|---|
platform Optional string | Only Messenger is supported |
call_id string | ID of the call from the connect webhook or accept response |
action string | Set to terminate |
Example response
{ "success" : true }
Error response
The following errors can occur:
- Invalid call ID or Page ID
- Call already terminated
- Cannot terminate a failed or completed call
- Permissions or authorization errors
For more details, see the Messenger Platform error codes reference.
Did you find this page helpful?
