Skip to main content
POST
/
transfer-call
curl -X POST https://api.magpipe.ai/functions/v1/transfer-call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "call_id": "7f3d8e00-a1b2-4c3d-9e4f-567890abcdef",
    "transfer_to": "+14155559999",
    "announce": "I am now transferring you to a specialist. Please hold."
  }'

{
  "success": true,
  "transfer_call_id": "8a4e9f00-b2c3-5d4e-0f1a-678901bcdef0"
}
Transfer an in-progress call to another phone number. The AI agent can announce the transfer before connecting the caller to the new number.

​
Request Body

​
call_id
string
required
The unique identifier of the active call to transfer.
​
transfer_to
string
required
The phone number to transfer the call to in E.164 format.
​
announce
string
Message the AI agent will speak before transferring the call. If omitted, the call transfers immediately.

​
Response

​
success
boolean
Whether the transfer was initiated successfully.
​
transfer_call_id
string
Unique identifier for the transfer leg of the call.
curl -X POST https://api.magpipe.ai/functions/v1/transfer-call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "call_id": "7f3d8e00-a1b2-4c3d-9e4f-567890abcdef",
    "transfer_to": "+14155559999",
    "announce": "I am now transferring you to a specialist. Please hold."
  }'

{
  "success": true,
  "transfer_call_id": "8a4e9f00-b2c3-5d4e-0f1a-678901bcdef0"
}