Agents

Create an agent

Changed on Mar 24, 2026

Creates a new voice AI agent.

Note: first_message and auto_first_message are mutually exclusive. Providing both returns a 400 error.

post/v2/agents

Request

Base URL
https://api.openmic.ai
URL
https://api.openmic.ai/v2/agents
Auth
HTTP bearer

Request body

namestring required

promptstring required

first_messagestring

Cannot be combined with auto_first_message: true.

auto_first_messageboolean

Cannot be combined with first_message.

knowledge_base_idinteger

voice_provider'OpenAI' | 'ElevenLabs' | 'Deepgram' | 'Cartesia'

voicestring

voice_modelstring

voice_speednumber

llm_model_namestring

llm_model_temperaturenumber

llm_max_tokensinteger

stt_provider'Deepgram'

stt_modelstring

auto_end_callboolean

boosted_keywordsstring[]

selected_jargonsstring[]

Response

Agent created.

uidstring required

Unique agent identifier (slug/UUID).