Skip to main content
The Calls API schedules immediate outbound calls and exposes their current state. A call is externally visible and may be billable once accepted.

​
Before creating a call

  • The agent has a published version.
  • The destination uses E.164 format.
  • The workspace allows the destination country and prefix, or has a valid SIP/BYOC route.
  • metadata contains every dynamic variable used by the prompt, or {} when none are required.

​
Lifecycle

  1. Create Call returns a signed call ID.
  2. Get Call shows the current status and eventual result.
  3. List Calls reconciles recent requests after a timeout.
  4. Webhooks notify your system of terminal outcomes without constant polling.

​
Duplicate prevention

The current contract does not publish an idempotency key. Store the returned call ID as soon as the response arrives. After a timed-out create request, list recent calls for the agent and match to_number and called_time before repeating it. See API reliability.

​
Call details and analytics

Use Get Call for the status, recording, and analysis of one call. Use Call History when an operator needs to browse, filter, or export calls in the dashboard.