APICallsOutbound Call

Start Outbound Call

Have an AI phone agent call a phone number now. phoneNumber (required): +1XXXXXXXXXX, or a 2-6 digit PBX extension for agents on a client PBX trunk. agentId (required): an active agent in your organization with outbound configured. variables (optional): key/value data passed to the agent for this call. voicemailMessage (optional): message the agent leaves if voicemail answers. The caller ID is the agent's default outbound number (Telephony → Set as default), otherwise its first assigned number. Each call uses minutes from your balance.

Created: September 16, 2026

Updated: September 16, 2026

Overview

POST

https://dashboard.vinsi.ai/api/calls/outbound

Request

Headers

Content-Type

string

application/json

x-api-key

string

REQUIRED

Request Body

{4 items"phoneNumber":string"+18055551234"
"agentId":string"cm9t3bqos0000l404og1m9a9z"
"variables":{2 items"customerName":string"Jordan"
"appointmentTime":string"Tuesday at 2 PM"
}
"voicemailMessage":string"Hi Jordan, this is Acme callin..."
}

Response

{4 items"status":int200
"roomName":string"outbound-18055551234-a1b2c3"
"dispatchId":string"AD_7Xk2mP9qLr4s"
"cluster":string"vinsi-do"
}

Endpoint Explorer

Note: You must be already authenticated on https://dashboard.vinsi.ai/ to use this API tester.

POST

Headers

Content-Type: *

x-api-key: *

Response

No response yet. Click Send to test the API.