Schedule Calls
Schedule or immediately dispatch one or more outbound calls in a single request. Each entry is processed independently — some may be scheduled, others dispatched or failed.Endpoint
Request Body
Assistant UUID to use for all calls
Phone number UUID to call FROM
Array of call entries. Each entry has:
phone_number(string, required) — destination in E.164 formatname(string, optional) — contact name for metadata
ISO datetime for future dispatch. If omitted or in the past, calls are dispatched immediately.
Force a specific provider:
krosai, twilio, or telnyx (optional)Arbitrary key-value metadata attached to all calls (optional)
Example Request
Response
dispatched, scheduled, or failed. Failed entries include an error field with the reason.

