Make Call
Tenant-scoped voice call operation for starting outbound AI calls or coordinating Twilio call setup.
POST
Tenant-scoped voice call operation for starting outbound AI calls or coordinating Twilio call setup.
Request body
MakeCallRequest
string,null
Optional stable agent key to resolve the currently published version
string,null
Optional agent name override
string,null
Optional explicit agent version id
object
Transient inline agent config for THIS call only (same shape and
validation as
POST /voice/agents config, including custom tools).
Mutually exclusive with agent_version_id.string,null
Source phone number (defaults to tenant’s Twilio number)
string,null
Optional custom greeting message for the AI agent
string,null
Answering-machine detection:
off, enable, or detect_message_end.
Defaults to off.integer,null (int32)
Max call attempts including the initial try (1..=5). Defaults to 1.
object
Opaque caller-supplied metadata (e.g. campaign ids). A JSON object of at
most 4 KB; persisted on the outbound attempt row and inherited by retry
children.
string,null
Optional organization ID for multi-org support
integer,null (int32)
Backoff before the next retry, in seconds (max 3600). 0 = immediate.
array,null
Terminal outcomes that should trigger a retry:
no_answer, busy,
failed, or voicemail (snake_case). Ignored when max_attempts == 1.string
required
Destination phone number (E.164 format recommended)
Response
MakeCallResponse
string,null
Twilio call SID for tracking
string,null
Error message (if failed)
string,null
Source phone number
boolean
required
Whether the call was initiated successfully
string,null
Current call status
string,null
Destination phone number