v2

latestOpenAPI 3.1.02026-08-05100545344.4 KB

Make a call

Initiates a real-time phone call through the AI agent.

post/calls

Headers

Authorizationstring required

Bearer authentication

Request body

model_idstring required

Agent ID. You can find it on the agent’s page in your dashboard.

phonestring required

Call recipient's phone number.

from_phone_numberstring

Optional outbound caller ID. Must match a phone number attached to the outbound agent.

namestring required

Call recipient's name.

lead_emailstring

The customer's email that can be used to book an appointment.

lead_timezonestring

The customer's time zone that can be used to book an appointment. For a list of all available time zones, see Time zones.

promptstring

The prompt that the agent will use.

greetingstring

The greeting the agent will use.

Response

200

statusstring
etainteger

How long it will take to initialize the call, in seconds.