Skip to main content
POST
/
api
/
make-call
{
  "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"
}
Initiate an outbound call from an agent to a destination number.
call_to
string
required
The destination phone number in E.164 format (e.g., +12345678900).
call_from
string
required
The source phone number (must be one of your imported numbers) in E.164 format.
agent_id
string
required
The ID of the agent to handle the call.
prompt_variables
object
Optional key-value pairs to inject into the agent’s prompt context for this call.

Response

success
boolean
Indicates if the call initiation was successful.
call_sid
string
The unique identifier for the call.
status
string
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"
}