> ## Documentation Index > Fetch the complete documentation index at: https://docs.ravan.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create Agent > Create Agent. Actual endpoint: `POST https://api.ravan.ai/api/v1/agents/` ### Authorizations Your Agni API key used to authenticate the request. Pass it in the `X-Api-Key` header. Find or rotate it from your Ravan AI account settings. *** ### Body The organization ID this agent belongs to. The public-facing display name for the agent. Agent status. Allowed values: `ACTIVE`, `INACTIVE`. The LLM model identifier used by the agent for reasoning and responses. The speech-to-speech model identifier used for realtime voice conversations. The voice ID used for the agent speech output. Controls response randomness. Lower values are more deterministic; higher values are more varied. Range: `0.0` – `1.0`. Milliseconds of silence before the agent sends a reminder message. Maximum number of reminder messages the agent can send during a call. The message the agent sends as a reminder during silence. Background sound profile to play during calls. Leave empty to disable. Volume for the ambient sound. Range: `0` (muted) to `1` (full volume). Maximum allowed call duration in milliseconds. Maximum time in milliseconds to let an outbound call ring before treating it as unanswered. Message to leave when voicemail is detected. Maximum time in milliseconds to wait for voicemail detection. Custom patterns used for voicemail detection. Pass `null` to disable. Model used to generate post-call analysis such as summaries and sentiment. Array of structured data fields to extract after the call. Field name for the extracted data. Description of what to extract. Data type: `string`, `enum`, `boolean`, `number`. Available choices (required when `type` is `enum`). Tools enabled for the agent. Pass `null` to disable. Knowledge base ID to attach to this agent. The first message the agent says when the conversation starts. Who speaks first. Allowed values: `agent`, `user`. The system prompt used by the agent. Supports template variables like `{{current_time_Asia/Calcutta}}`. List of webhook URLs to receive call events. Duration of silence in milliseconds after which the call ends automatically. Sensitivity for detecting user interruptions. Range: `0.0` – `1.0`. Whether the agent retains memory across turns in a conversation. IANA timezone used for calendar scheduling. Accent preferences for the agent voice. Whether the agent expresses emotion in its voice. Salesforce calendar ID for appointment scheduling. Backup phone number to transfer the call to on failure (E.164 format). *** ### Response Whether the request succeeded. Human-readable status message. Example: `Agent created successfully` Created agent object. Agent UUID. Example: `019ebc45-3cae-79b5-bd64-658da275fd08` Organization UUID. Example: `95a4e479-03a7-4f1b-834d-8705756e8e59` Display name of the agent. Example: `Input Field FROM EARTH` Agent status. Example: `ACTIVE` LLM model identifier. Example: `Agni Premium` Speech-to-speech model identifier. Example: `Agni Premium` Voice ID for TTS. Example: `Iris` LLM temperature setting. Example: `0.7` Milliseconds before sending a reminder. Example: `10000` Maximum reminders per call. Example: `2` Reminder message text. Example: `HI are you there??` Ambient sound identifier. Example: `forest_ambience` Ambient sound volume (0–1). Example: `1` Maximum call duration in milliseconds. Example: `600000` Ring duration in milliseconds. Example: `32000` Voicemail message text. Voicemail detection timeout in milliseconds. Example: `7000` Custom voicemail detection patterns. Post-call analysis model. Example: `gpt-4o-mini` Structured fields extracted after the call. Tools enabled for this agent. Attached knowledge base ID. Example: `8619dc3f-.......` Opening message spoken by the agent. Who speaks first. Example: `agent` System prompt used by the agent. Webhook URLs receiving call events. Example: `["https://webhook.site/"]` Silence duration in ms before call ends. Example: `10000` Interruption detection sensitivity. Example: `0.1` Whether memory is enabled. Example: `true` Calendar timezone. Example: `Asia/Calcutta` Accent preferences. Example: `["india/hindi"]` Whether emotion is enabled. Example: `true` Cal.com integration status. Example: `inactive` GHL assigned user IDs. CRM sync provider configuration. Salesforce calendar ID. Salesforce assigned user IDs. Emergency fallback phone number. Example: `+919123456789` Creation timestamp. Example: `2026-06-12 14:38:34.670214 +0000 UTC` Last updated timestamp. Example: `2026-06-12 14:38:34.670214 +0000 UTC`