Skip to main content
POST

Request

Create a new AI voice agent with custom personality, voice, and behavior settings.

Headers

string
required
Bearer token for authentication. Format: Bearer YOUR_API_KEY
string
required
Must be application/json

Body Parameters

string
required
A friendly name for the agent (e.g., “Sales Assistant”)
string
required
The instructions defining the agent’s personality, goals, and behavior
string
required
The voice to use for the agent. See available voices.
string
The greeting message the agent says when the call connects
string
default:"en-US"
Primary language for the agent (e.g., en-US, es-ES, fr-FR)
string
default:"gpt-4o"
The LLM to use: gpt-4o, gpt-4o-mini, claude-3-sonnet
number
default:"0.7"
Creativity level (0.0-1.0). Lower = more focused, higher = more creative.
integer
default:"150"
Maximum tokens per response (affects verbosity)
number
default:"0.5"
How easily the user can interrupt (0.0-1.0). Higher = easier to interrupt.
array
Phrases that will end the call (e.g., ["goodbye", "that's all"])
object
Custom key-value pairs for your reference

Response

string
Unique identifier for the agent
string
The agent’s name
string
The voice ID
string
Agent status: active, inactive
string
ISO 8601 timestamp

Error Codes