Skip to main content
Create and deploy a voice agent in minutes.
Prerequisites: API key, phone number (see Phone Number Management to select one)
1

Create Your Agent

import requests

response = requests.post(
    'https://dev.voice.ai/api/v1/agent/',
    headers={'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'},
    json={
        'name': 'My First Agent',
        'config': {
            'prompt': 'You are a helpful call center agent. Help customers with billing, returns, and questions.',
            'greeting': 'Thank you for calling. How can I help you?',
            'llm_model': 'gemini-2.5-flash-lite',
            'allow_interruptions': True,
            'min_interruption_words': 1,
            'auto_noise_reduction': True
        }
    }
)

agent_id = response.json()['agent_id']
print(f'Agent ID: {agent_id}')
2

Assign a Phone Number

Assign your phone number to the agent:
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}

# Pause agent to update
requests.post(f'https://dev.voice.ai/api/v1/agent/{agent_id}/pause', headers=headers)

# Update agent with phone number
requests.put(
    f'https://dev.voice.ai/api/v1/agent/{agent_id}',
    headers=headers,
    json={'config': {'phone_number': '+14155551234'}}
)

print('Phone number assigned!')
3

Deploy

Deploy your agent to make it active:
import requests

requests.post(
    f'https://dev.voice.ai/api/v1/agent/{agent_id}/deploy',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

print('Agent deployed!')

​
Test Your Agent

Call your assigned phone number to test your agent. The agent will answer with your configured greeting and handle conversations based on your prompt.

Phone Number Management

Search, select, and assign phone numbers

Agent Configuration

Complete reference for all configuration parameters

API Reference

Complete API documentation