Skip to main content
POST
/
v1
/
calls
/
outbound
curl -X POST https://api.vozagent.ai/v1/calls/outbound \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+15551234567",
    "assistant_name": "Voz",
    "first_name": "John",
    "last_name": "Smith",
    "notes": "Interested in a kitchen remodel quote"
  }'

{
  "call_id": "call-a1b2c3d4-e5f6-a7b8",
  "status": "queued",
  "direction": "outbound",
  "to_phone": "+15551234567",
  "assistant_name": "Voz",
  "contact_id": "c1a2b3c4-d5e6-f7a8",
  "is_new_contact": false,
  "created_at": "2024-01-15T12:00:00Z"
}
Retrieve your API Key from your VozAgent Dashboard.
Triggers an AI-powered outbound call. The assistant will call the specified phone number and handle the conversation based on its configuration. Requires an active subscription and the calls:write scope.

​
Body parameters

​
phone_number
string
required
The destination phone number to call (E.164 format, e.g., +15551234567).
​
assistant_id
string
The ID of the assistant to make the call. Either assistant_id or assistant_name is required.
​
assistant_name
string
The name of the assistant to make the call. Either assistant_id or assistant_name is required.
​
first_name
string
First name of the contact being called. Used for personalization.
​
last_name
string
Last name of the contact being called.
​
source
string
Lead source identifier (e.g., “website”, “referral”).
​
tags
string | string[]
Tags to associate with the contact. Can be a single string or an array of strings.
​
notes
string
Additional notes or context for the call. Can be used to provide the assistant with background information.

​
Response

Returns the created call object. The call will be initiated asynchronously. Status code: 201. 
curl -X POST https://api.vozagent.ai/v1/calls/outbound \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+15551234567",
    "assistant_name": "Voz",
    "first_name": "John",
    "last_name": "Smith",
    "notes": "Interested in a kitchen remodel quote"
  }'

{
  "call_id": "call-a1b2c3d4-e5f6-a7b8",
  "status": "queued",
  "direction": "outbound",
  "to_phone": "+15551234567",
  "assistant_name": "Voz",
  "contact_id": "c1a2b3c4-d5e6-f7a8",
  "is_new_contact": false,
  "created_at": "2024-01-15T12:00:00Z"
}