Skip to main content
POST
Initiate individual call (compatibility)

Authorizations

X-API-KEY
string
header
required

Body

application/json
name
string
required

Callee name. Also exposed to the prompt as callee_name unless you set that key yourself.

mobile_number
string
required

Destination in E.164. Also exposed to the prompt as mobile_number.

agent_id
string
required

A published voice agent.

from_number_id
string

Caller-ID phone-number id. Takes precedence over from_number.

from_number
string

Caller ID in E.164. A list of numbers is also accepted; the first usable one wins. Resolved to a workspace number; 404 if it is not one. from_number_id takes precedence.

custom_args_values
object

Prompt variables. Maps to the native custom_variables.

call_config
object

Same shape as the native call_config — idle timeouts, retries, calling window.

smart_formatter
object

Accepted and stored, but not applied.

Response

Call initiated. call_status uses the compatibility vocabulary (registered, ongoing, completed, failed, cancelled).