Create Agent

Create a new agent.

An agent represents an AI persona (Support Bot, Sales Agent, etc.) that can have phone numbers attached to it.

voiceMode: “webhook” (default) forwards transcripts to your webhook. “hosted” uses a built-in LLM with systemPrompt (no webhook needed).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired
descriptionstring or nullOptional
voiceModeenumOptional
Allowed values:
modelTierenumOptional
Allowed values:
systemPromptstring or nullOptional
beginMessagestring or nullOptional
voicestring or nullOptional
transferNumberstring or nullOptional
voicemailMessagestring or nullOptional
sttModeenumOptional

Speech-to-text mode. ‘fast’ optimizes for latency, ‘accurate’ optimizes for transcription accuracy (~200ms additional latency).

Allowed values:
ambientSoundenumOptional

Background ambience to mask synthetic silence between turns. ‘none’ disables; ‘office’, ‘coffee-shop’, ‘outdoor’ enable a quiet bed.

Allowed values:
denoisingModeenumOptional

Audio denoising. ‘noise-cancellation’ (default) handles general noise. ‘noise-and-background-speech-cancellation’ is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge).

Allowed values:

Response

Successful Response
idstring
namestring
descriptionstring or null
voiceModeenum
Allowed values:
voicestring
createdAtdatetime
modelTierenumDefaults to balanced
Allowed values:
systemPromptstring or null
beginMessagestring or null
transferNumberstring or null
voicemailMessagestring or null
sttModeenumDefaults to fast

Speech-to-text mode. ‘fast’ optimizes for latency, ‘accurate’ optimizes for transcription accuracy (~200ms additional latency).

Allowed values:
ambientSoundenumDefaults to none

Background ambience to mask synthetic silence between turns. ‘none’ disables; ‘office’, ‘coffee-shop’, ‘outdoor’ enable a quiet bed.

Allowed values:
denoisingModeenumDefaults to noise-cancellation

Audio denoising. ‘noise-cancellation’ (default) handles general noise. ‘noise-and-background-speech-cancellation’ is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge).

Allowed values:
numberslist of objects or null

Errors

422
Unprocessable Entity Error