Calls

Initiate a phone call

Start an outbound phone call with an AI agent

Authentication

AuthorizationBearer

Clerk JWT token or OrtaVox API key (sk_live_… or pk_live_…)

OR
x-api-keystring

OrtaVox API key (alternative to Bearer token)

Request

This endpoint expects an object.
from_numberstringRequiredformat: "^\+[1-9]\d{1,14}$"

Phone number to call from (E.164 format) - must be a registered phone number

to_numberstringRequiredformat: "^\+[1-9]\d{1,14}$"

Phone number to call to (E.164 format)

agent_idstringRequiredformat: "uuid"
ID of the agent to use for the call
dynamic_variablesmap from strings to anyOptional

Optional dynamic variables to pass to the agent (key-value pairs)

Response

Phone call initiated successfully
dataobject or null

Errors