Initiate an outbound call from an agent to a destination number.
The destination phone number in E.164 format (e.g., +12345678900).
The source phone number (must be one of your imported numbers) in E.164 format.
The ID of the agent to handle the call.
Optional key-value pairs to inject into the agent’s prompt context for this call.
Response
Indicates if the call initiation was successful.
The unique identifier for the call.
Initial status of the call (e.g., initiated, calling).
{
"call_to": "+15559876543",
"call_from": "+15551234567",
"agent_id": "agent_abc",
"prompt_variables": {
"customer_name": "Alice",
"appointment_time": "3:00 PM"
}
}
{
"success": true,
"call_sid": "call_xyz789",
"to": "+15559876543",
"from": "+15551234567",
"agent_id": "agent_abc",
"call_type": "twilio",
"status": "initiated"
}