Create Agent
AI Agents
Create Agent
Create a new AI agent with custom configuration. Define the agent’s name, general prompt, and optional webhook settings for call completion callbacks.
POST
Create Agent
Create Agent
Create a new AI agent with custom configuration. Define the agent’s name, general prompt, and optional webhook settings for call completion callbacks.string
required
Bearer token in the format:
Bearer {access_token}string
required
Must be set to
application/jsonstring
required
A descriptive name for your AI agent
string
required
The main system prompt that defines the agent’s behavior and purpose. This guides how the agent interacts during calls.
string
Optional callback URL that will be called when the agent completes a call. Leave empty if not needed.
string
HTTP method for the webhook callback. Must be either
GET or POST. Defaults to POST if not specified.string
Unique identifier for the newly created agent
string
The name of the created agent
string
Status of the agent creation (typically “active” or “pending”)
Authorizations
Bearer token authentication. Include the access token in the Authorization header as 'Bearer {access_token}'
Body
application/json
A descriptive name for your AI agent
The main system prompt that defines the agent's behavior and purpose. This guides how the agent interacts during calls.
Optional callback URL that will be called when the agent completes a call. Leave empty if not needed.
HTTP method for the webhook callback. Must be either GET or POST. Defaults to POST if not specified.
Available options:
GET, POST