Skip to main content
POST
Create Call

Authorizations

Authorization
string
header
required

API key authentication.

X-User-ID
string
header
required

Required user id for API key requests.

Body

application/json
phone_number_id
string
required

The phone_number_id to place the call from

to_number
string
required

Destination number in E.164 format

assistant_id
string | null

Optional: force an assistant for this call

label
string | null

Optional label for tracking

Response

Successful Response

id
string
required
to_number
string
required
provider
string
required
status
string
required
phone_number_id
string | null
assistant_id
string | null
from_number
string | null
provider_call_sid
string | null
direction
string | null
created_at
string | null
started_at
string | null
ended_at
string | null
ended_reason
string | null
duration_seconds
integer | null
timestamp
string | null
summary
string | null
user_messages
integer | null
agent_messages
integer | null
recording_url
string | null
stereo_recording_url
string | null
recording_mp3_url
string | null
stereo_recording_mp3_url
string | null
latency_metrics
Latency Metrics · object | null
per_turn_latency
any[] | null
cost
number | null
total_credits
integer | null
cost_breakdown
Cost Breakdown · object | null
costs
any[] | null