Agents
Create Agent
Create a new AI voice agent
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_KEYstring
required
Must be
application/jsonBody 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-sonnetnumber
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, inactivestring
ISO 8601 timestamp