Initiate Call

Start an outbound call from an assistant to a phone number. Supports both immediate dispatch and future scheduling.

Endpoint

Request Body

assistant_id
string
required
Assistant UUID
customer_phone
string
required
Destination phone number (E.164 format)
phone_number_id
string
Phone number UUID to call from (optional, inferred if omitted)
scheduled_at
string
ISO datetime to schedule the call for. If omitted or in the past, the call is dispatched immediately.
initiate_via
string
Force a specific provider: krosai, twilio, or telnyx (optional)
metadata
object
Arbitrary key-value metadata to attach (optional)

Example Request

Response

For scheduled calls the response returns "status": "scheduled" with no session_id:

Errors