Skip to main content
POST
Create an agent

Authorizations

x-api-key
string
header
required

Body

application/json
agent_name
string
default:Sofia - Friendly Support
required

Display name for the avatar persona.

agent_system_prompt
string
default:Speak in a warm, engaging tone and provide clear answers.
required

Behavioral prompt for the avatar interaction style.

avatars
object[]
required

List of avatars associated with this agent.

config
object
required

Agent-level configuration properties.

knowledge_base
object[] | null

List of knowledge bases attached to this agent.

tool
object[] | null

List of tools attached to this agent.

mcp
object[] | null

List of MCPs attached to this agent.

record
boolean
default:true

Determines whether voice call recordings should be stored.

callback_events
string[]

Webhook events that should trigger callbacks.

Example:
callback_url
string

Webhook endpoint URL to send callback events to.

Example:

"https://webhooks.example.com/agent-events"

Response

Agent created successfully!

id
string
message
string