Skip to main content
The VozAgent API lets you integrate AI-powered voice automation directly into your applications. Manage contacts, trigger outbound calls, configure assistants, and receive real-time webhooks — all through a simple REST API.

Contacts

Create, list, update, and delete contacts.

Calls

List calls and trigger outbound calls.

Assistants

List and retrieve your AI assistants.

Phone Numbers

Manage your phone number inventory.

Webhooks

Real-time event notifications.

​
Base URL

All API requests should be made to the following base URL: 
https://api.vozagent.ai/v1

​
Authentication

The VozAgent API uses API keys to authenticate requests. You can view and manage your API keys in your VozAgent Dashboard. Include your API key in all requests via the Authorization header: 
Authorization: Bearer YOUR_API_KEY
Keep your API key secret! Do not share your API key in publicly accessible areas such as GitHub, client-side code, or anywhere that could be exposed.

​
Rate Limits

The API enforces fair usage limits to maintain service quality for all users. Current limits are generous and apply equally across all plans. If you encounter rate limiting, reduce the frequency of your requests or add delays between calls.
PlanRate Limit
EssentialStandard
GrowthStandard
AdvancedStandard
EnterpriseCustom limits
If you need higher throughput for your use case, contact us to discuss Enterprise limits.

​
Error Handling

VozAgent uses conventional HTTP response codes to indicate the success or failure of an API request.
CodeDescription
2xxSuccess
4xxClient error (e.g., bad request, unauthorized, not found)
5xxServer error (something went wrong on our end)
Error responses include a JSON body with details: 
{
  "error": {
    "code": "invalid_request",
    "message": "The request body is missing required fields",
    "details": {
      "missing_fields": ["phone_number"]
    }
  }
}

​
API Versioning

The current version of the API is v1. The version is included in the URL path. We strive to make backwards-compatible changes when possible. When breaking changes are necessary, we will release a new API version and provide migration guides.

​
Get Started

List Your Contacts

Retrieve your existing contacts to verify your API connection.

Create an Outbound Call

Programmatically initiate AI-powered outbound calls.

Set Up Webhooks

Receive real-time notifications about call events.

Browse Assistants

List and inspect your configured AI assistants.