Skip to main content
POST
Start Call

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace_id
string
required
agent_id
string
required

Body

application/json

Start an outbound call from a workspace agent. Only to_phone is required.

to_phone
string
required

Phone number to call, in E.164 format (for example +61400000000). This is the person the AI agent rings.

from_phone
string | null

Voqo number the call is made from, in E.164 format. Optional: when omitted, the number connected to this agent is used. The request fails with 404 if the agent has no connected number.

record
boolean | null
default:true

Record the call. Defaults to true. Recordings appear in Call Logs and in the post-call webhook.

parameters
Parameters · object | null

Optional key-value pairs the agent can use during the call, such as the callee's name or the meeting time. Reference them in the agent prompt.

Example:

Response

Call started successfully

Response schema for starting a call

to_phone
string
required

To phone number

created_by
string
required

Created by

from_phone
string | null

From phone number

record
boolean | null
default:true

Whether to record the call

status
enum<string>
default:created

Call status

Available options:
created,
initiated,
connected,
inprogress,
completed,
failed
created_at
string<date-time> | null

Call created at