Skip to main content
POST
Create Bot

Authorizations

Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as: Authorization: Bearer <your-api-key>

Body

application/json

Bot configuration details

name
string
required

Name of the bot (max 255 characters)

Maximum string length: 255
prompt
string
required

System prompt for the bot

first_message
string

Initial message the bot will send

knowledge_base_id
integer

ID of the knowledge base to use

voice_provider
enum<string>

Voice synthesis provider

Available options:
OpenAI,
ElevenLabs,
Deepgram
voice
string

Voice ID or name

voice_model
string

Voice model to use

voice_speed
number

Speech speed multiplier

llm_model_name
string

Large language model to use

llm_model_temperature
number

Temperature setting for the LLM

stt_provider
enum<string>

Speech-to-text provider

Available options:
Deepgram
stt_model
string

Speech-to-text model

call_settings
object
advanced_settings
object
post_call_settings
object

Response

Bot created successfully

id
string
required

Unique identifier of the bot

name
string
required

Name of the bot

prompt
string
required

System prompt for the bot

created_at
string<date-time>
required

Bot creation timestamp

updated_at
string<date-time>
required

Bot last update timestamp

first_message
string

Initial message the bot will send

knowledge_base_id
integer

ID of the knowledge base

voice_provider
enum<string>

Voice synthesis provider

Available options:
OpenAI,
ElevenLabs,
Deepgram
voice
string

Voice ID or name

voice_model
string

Voice model being used

voice_speed
number

Speech speed multiplier

llm_model_name
string

Large language model being used

llm_model_temperature
number

Temperature setting for the LLM

stt_provider
enum<string>

Speech-to-text provider

Available options:
Deepgram
stt_model
string

Speech-to-text model

call_settings
object
advanced_settings
object
post_call_settings
object