Skip to main content
POST
https://mtxbiyilvgwhbdptysex.supabase.co/functions/v1
/
transfer-call
curl -X POST https://mtxbiyilvgwhbdptysex.supabase.co/functions/v1/transfer-call \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -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://mtxbiyilvgwhbdptysex.supabase.co/functions/v1/transfer-call \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -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"
}