Calls

Create an outbound phone call

Initiates a new outbound phone call from a number registered in your organization.

Rate limit: 5 requests per minute.

post/v2/create-phone-call

Request

from_numberstring required

E.164 format caller number (e.g. +12025551234).

to_numberstring required

E.164 format destination number.

override_agent_uidstring

Override the default agent assigned to the from_number.

customer_idstring

Your internal customer reference. Stored with the call record.

dynamic_variablesobject

Key-value pairs injected into the agent prompt as template variables at call time.

callback_urlstring uri

Webhook URL called with call status updates.

Call created and queued.

idstring required

CUID call identifier.

from_numberstring required

to_numberstring required

call_status'registered' | 'ongoing' | 'ended' | 'error' required

call_type'phonecall' | 'webcall'

agent_uidstring

customer_idstring

dynamic_variablesobject

callback_urlstring

created_atstring date-time required

updated_atstring date-time required