---
title: "Create Call"
method: POST
path: "/v1/calls"
tags: ["Calls"]
---

# Create Call

`POST /v1/calls`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/calls`
- Auth: HTTP bearer

Make an outbound phone call from your AI agent.

Dials a real person or business from the agent's number. The agent holds
the whole conversation on its own with its system prompt, voice and
greeting (or this call's overrides). The call reaches a third party and
is billed to the account at $0.12 per minute, first minute charged in
full, so confirm with the user first. Not idempotent: every successful
call dials again.

Prerequisites: an agent with an active number from buy_phone_number
(HTTP 400 otherwise), plus remaining subscription minutes or at least
$0.50 of wallet balance (HTTP 402 otherwise). Included minutes are used
first; only uncovered call time is charged to the wallet.

Returns right after dialing with the call id (call_...), agent_id,
from_number, to_number, direction, status and started_at; the call runs
on its own. Check get_call_details for progress and call
get_call_transcript once status is completed.

## Request body

- CallRequest
  - `agent_id` string, required: ID of the AI agent making the call (e.g. 'agt_abc123')
  - `to_number` string, required: Destination phone number in E.164 format (e.g. '+12125551234')
  - `system_prompt` string, nullable: Per-call system prompt override. Replaces the agent's default prompt for this call ONLY. If omitted, the agent's default system_prompt is used.
  - `initial_greeting` string, nullable: Per-call greeting override. Replaces the agent's default greeting for this call ONLY. If omitted, the agent's default initial_greeting is used.
  - `voice_id` string, nullable: Override the TTS voice for this call: preset name (e.g. 'female-1') or a voice UUID
  - `from_number_id` string, nullable: Specific phone number ID to call from; defaults to the agent's assigned number

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)