Skip to main content
POST
/
calls
/
start
Start an outbound call
curl --request POST \
  --url https://api.vocobase.com/api/v2/calls/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "to_number": "+919876543210",
  "provider": "mcube"
}
'
{
  "success": true,
  "data": {
    "call_id": "c1234567-abcd-1234-abcd-123456789012",
    "session_id": "s1234567-abcd-1234-abcd-123456789012",
    "status": "pending",
    "provider": "twilio",
    "from_number": "+14155551234",
    "to_number": "+919876543210",
    "agent_id": "a1234567-abcd-1234-abcd-123456789012"
  }
}

Authorizations

Authorization
string
header
required

API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.

Body

application/json
agent_id
string<uuid>
required

ID of the agent to use for this call.

to_number
string
required

Destination phone number in E.164 format.

Example:

"+919876543210"

provider
enum<string>
default:mcube

Telephony provider. Defaults to mcube if not specified.

Available options:
mcube,
twilio

Response

Call initiated successfully.

success
boolean
data
object