POST/calls/outboundScope: calls:trigger

Create Outbound Call

Dispatches an outbound SIP phone call to a recipient. Once the recipient answers, the assigned AI voice agent starts the conversation, listens to speech, executes tools, and captures transcripts and analytics.

⚠️Pre-flight Calling Checklist0/4 ready

Request Attributes & Parameters4 parameters

agentIdstringrequiredin body

The unique ID of the Live voice agent to execute the call.

example:6701a2b3c4d5e6f7a8b9c0d1

phoneNumberstringrequiredin body

Recipient phone number formatted in E.164 (country code + subscriber digits).

example:+919876543210

phoneNumberIdstringoptionalin body

Specific outbound caller ID number ID. If omitted, the latest ready number assigned to the agent is used.

metadataobjectoptionalin body

Custom key-value JSON object returned in call logs, transcripts, and webhooks for correlation with your CRM.

Zero-Contact Troubleshooting Matrix

409 Import or buy a phone number with Outbound or Both direction...

Root Cause: The agent does not have an active phone number configured for Outbound calling.

Recommended Fix: Go to Dashboard → Phone Numbers, click on your number, ensure Direction is set to 'Outbound' or 'Both', and confirm it is assigned to this Agent.

409 The selected outbound number changed / admission locked

Root Cause: Another concurrent call is already utilizing this specific single-channel phone number.

Recommended Fix: Wait a moment for the channel to release, or attach additional phone numbers or multi-channel trunking in Dashboard → Phone Numbers.

400 Phone number must be in E.164 format

Root Cause: The destination phone number is missing a plus sign or country code (e.g. '9876543210' instead of '+919876543210').

Recommended Fix: Ensure all numbers start with a plus sign followed by country code, e.g., '+91' for India, '+1' for US/Canada.