Create Call
Make an outbound phone call from your AI agent.
Initiates a real phone call from the AI agent’s phone number to the specified destination. The agent uses its configured system prompt, voice, and greeting to conduct the conversation autonomously.
The AI agent handles the entire call — speech-to-text, LLM reasoning, and text-to-speech — in real time. The call transcript is saved automatically and can be retrieved via GET /v1/calls//transcript.
Request body:
- agent_id: the AI agent making the call
- to_number: destination phone number in E.164 format (e.g. “+12125551234”)
- from_number_id: (optional) specific number to call from
- system_prompt: (optional) override the agent’s default prompt for this call
- initial_greeting: (optional) override the agent’s greeting for this call
- voice_id: (optional) override the voice for this call
Authorizations
AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp then POST /v1/auth/verify). Pass as: Authorization: Bearer sk_live_...
Body
ID of the AI agent making the call (e.g. 'agt_abc123')
Destination phone number in E.164 format (e.g. '+12125551234')
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.
Per-call greeting override. Replaces the agent's default greeting for this call ONLY. If omitted, the agent's default initial_greeting is used.
Override the TTS voice for this call: preset name (e.g. 'female-1') or Cartesia UUID
Specific phone number ID to call from; defaults to the agent's assigned number
Response
Successful Response