Skip to main content
POST
Create Voice Agent

Authorizations

Authorization
string
header
required

Pass the API key in the Authorization header, You need to put Token keyword before the API key. e.g. 'Authorization: Token '

Body

application/json
name
string
required

Name of the voice agent (max 150 characters).

Maximum string length: 150
Example:

"Customer Support Agent"

type
enum<string>
default:Single Prompt

Type of voice agent.

Available options:
Single Prompt,
Flow Agent
Example:

"Single Prompt"

conversation
object

Conversation settings for the voice agent.

voice
object

Voice settings for the agent.

llm
object

LLM configuration.

callSettings
object

Call and audio settings.

tools
object[]

Web tools attached to the agent.

knowledgeBaseItemsIds
string<uuid>[]

Array of knowledge base item UUIDs.

Example:
voiceDictionaryIds
string<uuid>[]

Array of voice dictionary UUIDs.

Example:
phoneNumber
object | null

Phone number configuration.

webhookUrl
string<uri>

Webhook URL for external integrations.

Example:

"https://example.com/webhook"

webhookAuth
object

Webhook authentication configuration.

workflow
object | null

Workflow graph for Flow Agents (type = "Flow Agent"). Ignored for Single Prompt agents.

Example:
outcomeResponseShape
object

Expected outcome response structure.

Response

Successful response

success
boolean
Example:

true

message
string
Example:

"Voice agent created successfully"

messageKey
string
Example:

"VoiceAgentCreatedSuccessfully"

data
object

Voice agent data structure