Skip to main content
POST
Create a call

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json
agentId
string
required

The agent to run this call. Must be ACTIVE.

phoneNumber
string

Falls back to the agent's assigned number when omitted.

to
string

Destination number, for outbound use.

recordingEnabled
boolean

Overrides the agent's own recording setting for this call.

metadata
object

Arbitrary values echoed back on the call record.

Response

Call created

id
string
status
string
joinUrl
string

Short-lived, single-use URL to connect to this call.

createdAt
string<date-time>