Skip to main content
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 fields
  • 401 Unauthorized — Invalid or missing API key
  • 500 Internal Server Error — Server-side error

Code Examples