Create Outbound Call
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
2026-03-01 "2026-03-01"
Body
Request body for starting outbound calls from an agent phone number.
Phone number ID to place calls from. The attached provider handles outbound calling for this number.
Agent that handles the outbound calls.
Per-call destination and metadata configuration. Every destination dials immediately, so destinations beyond the organization's agent-call concurrency limit are rejected rather than queued. For larger lists, use POST /agents/calls/batches instead.
1Seconds to wait for the callee to answer before giving up. Omit to use the default (60 seconds).
5 <= x <= 80Optional maximum call duration in minutes.
Response
Outbound call requests accepted. Destinations succeed or fail individually, so check each calls entry for an error rather than relying on the status code alone.
Result for one destination, carrying either an agent_call_id or an error.
- AgentOutboundCallItemResponse
- AgentOutboundCallItemResponse