---
title: "Create Agent"
method: POST
path: "/api/v1/agents/"
tags: ["AgentService"]
---

# Create Agent

`POST /api/v1/agents/`

## Request

- Base URL: `https://api.ravan.ai`
- URL: `https://api.ravan.ai/api/v1/agents/`
- Auth: API key in header `X-Api-Key`

## Request body

- CreateAgentRequest
  - `widget_settings_id` string
  - `name` string
  - `agent_name` string
  - `model` string
  - `s2s_model` string
  - `voice_id` string
  - `temperature` number, double
  - `reminder_trigger_ms` integer
  - `reminder_max_count` integer
  - `ambient_sound` string
  - `ambient_sound_volume` number, double
  - `end_call_after_silence` boolean
  - `max_call_duration_ms` integer
  - `ring_duration_ms` integer
  - `enable_voicemail_detection` boolean
  - `voicemail_message` string
  - `voicemail_detection_timeout_ms` integer
  - `enable_emergency_fallback` boolean
  - `emergency_fallback_number` string
  - `ivr_options` object
  - `post_call_analysis_model` string
  - `analysis_summary_prompt` string
  - `selected_tools` object
  - `integrations` object
  - `knowledge_base` string
  - `begin_message` string
  - `start_speaker` string

## Response `200`

Successful response

- CreateAgentResponse
  - `success` boolean
  - `message` string
  - `data` Agent
    - `id` string: Unique agent ID
    - `organization_id` string: Organization this agent belongs to
    - `widget_settings_id` string: Associated widget settings ID
    - `name` string: Internal name of the agent
    - `agent_name` string: Display name of the agent
    - `status` 'AGENT_STATUS_UNSPECIFIED' | 'AGENT_STATUS_ACTIVE' | 'AGENT_STATUS_INACTIVE': Status of the agent
    - `model` string: LLM model identifier
    - `s2s_model` string: Speech-to-speech model identifier
    - `voice_id` string: Voice ID for TTS
    - `temperature` number, double: LLM temperature setting
    - `reminder_trigger_ms` integer: Milliseconds before sending a reminder
    - `reminder_max_count` integer: Maximum number of reminders to send
    - `ambient_sound` string: Ambient sound identifier
    - `ambient_sound_volume` number, double: Volume of ambient sound (0.0 - 1.0)
    - `end_call_after_silence` boolean: Whether to end the call after silence
    - `max_call_duration_ms` integer: Maximum call duration in milliseconds
    - `ring_duration_ms` integer: Ring duration in milliseconds
    - `enable_voicemail_detection` boolean: Whether to enable voicemail detection
    - `voicemail_message` string: Message to leave on voicemail
    - `voicemail_detection_timeout_ms` integer: Voicemail detection timeout in milliseconds
    - `enable_emergency_fallback` boolean: Whether to transfer the call to a backup number on failure
    - `emergency_fallback_number` string: The backup number to transfer the call to
    - `ivr_options` object: IVR (Interactive Voice Response) configuration
    - `post_call_analysis_model` string: Model to use for post-call analysis
    - `analysis_summary_prompt` string: Prompt used for generating call summary
    - `selected_tools` object: Tools selected for this agent
    - `integrations` object: Integration configuration
    - `knowledge_base` string: Knowledge base content or reference
    - `begin_message` string: Opening message spoken by the agent
    - `start_speaker` string: Who speaks first: agent or user
    - `created_at` string: Creation timestamp
    - `updated_at` string: Last update timestamp

## Changes

- **2026-11-03** `53e6f393f46e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ravan/apis/agni-api/changes/api/v1/agents/post.md)

---

[API](https://skmtc.dev/ravan/apis/agni-api.md) - [All operations](https://skmtc.dev/ravan/apis/agni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ravan/apis/agni-api/revisions/53e6f393f46e?raw)