Agentes
Create Agent
Create a new AI phone agent
POST
Creates a new AI phone agent in your organization. The agent can then be used to make outbound calls or handle inbound calls.
Headers
string
requerido
Your API key for authentication. Found in your dashboard under API settings.
Body
string
requerido
The agent’s display name.
string
requerido
The voice ID to use for the agent. Use List Voices to retrieve available voice IDs.
string
requerido
The agent’s timezone in IANA format (e.g.
America/Mexico_City, America/New_York, America/Argentina/Buenos_Aires).string
The human name the agent introduces itself as during calls.
string
Language code for the agent (e.g.
en-US, es-ES). Defaults to the organization default.string
Background sound to play during calls (e.g.
office, cafe).number
How sensitive the agent is to being interrupted. Value between
0.1 and 1.0. Higher values mean the agent stops speaking more easily when interrupted.string
URL to receive call event webhooks for this agent.
Response
Returns the created agent object.string
Unique identifier of the created agent.
string
The agent’s display name.
string
The voice ID assigned to the agent.
string
The agent’s timezone.
string
Timestamp when the agent was created (ISO 8601).
Error Codes
400 Bad Request— Invalid or missing required fields401 Unauthorized— Invalid or missing API key500 Internal Server Error— Server-side error
