Skip to main content
POST
Create Call

Authorizations

Authorization
string
header
required

Your API key. Send in the Authorization header as: Bearer

Headers

X-Idempotency-Key
string | null

Body

application/json

Create an outbound call via the Public API. Organization is set from API key; direction is always outbound.

agent_id
string
required

Agent ID to use for the call

Example:

"agt_123e4567-e89b-12d3-a456-426614174000"

phone_number
string
required

Destination phone number in E.164 format (the number to call)

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15551234567"

from_number
string | null

Caller ID / originating phone number in E.164 format. Must be a number assigned to this agent. If omitted, the system picks from the agent's assigned outbound numbers automatically.

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15559876543"

call_settings
PublicCallSettings · object | null

Optional per-call settings (recording, greeting, timeouts)

variables
Variables · object | null

Key-value pairs for mustache template substitution in agent prompts (e.g. first_name, company)

Response

Successful Response

data
PublicCallResponse · object
required

Call object

meta
ResponseMeta · object
required

Request metadata