---
title: "Create Outbound Call"
method: POST
path: "/agents/calls"
tags: ["Agents"]
---

# Create Outbound Call

`POST /agents/calls`

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Request body

- AgentOutboundCallRequest — Request body for starting outbound calls from an agent phone number.
  - `from_number_id` string, required — Phone number ID to place calls from. The attached provider handles outbound calling for this number.
  - `agent_id` string, required — Agent that handles the outbound calls.
  - `outbound_calls` AgentOutboundCallItem[], required — Per-call destination and metadata configuration.
    - `to_number` string, required — Destination phone number for this outbound call, in E.164 format (e.g., `+14155559876`).
    - `metadata` object, nullable — Custom metadata passed to the agent code deployment.
  - `ringing_timeout_seconds` integer — Seconds to wait for the callee to answer before giving up. Omit to use the default (60 seconds).
  - `max_call_duration_minutes` integer — Optional maximum call duration in minutes.

## Response `200`

Outbound call requests accepted.

- AgentOutboundCallResponse
  - `calls` AgentOutboundCallItemResponse[], required
    - `number` string, required — Destination phone number for this outbound call, in E.164 format (e.g., `+14155559876`).
    - `agent_call_id` string, required — Agent call ID for tracking per-call information.
    - `error` object, nullable — Error for this destination when the provider could not start the call.

## Other responses

- `400` — Invalid request body, missing required fields, invalid metadata, invalid `ringing_timeout_seconds`, unsupported telephony provider, or a phone number configuration that cannot place outbound calls.
- `403` — The phone number does not belong to the same organization as the agent.
- `404` — Agent, phone number, or deployment not found.
- `500` — Outbound calling is temporarily unavailable, or provider setup failed.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/revisions/8910812440d3/schema)