---
title: "Create Agent"
method: POST
path: "/public/agent"
tags: ["agent"]
---

# Create Agent

`POST /public/agent`

Creates a new AI agent with the specified configuration. The agent will be created with a single prompt-based flow.

## Headers

- `X-API-KEY` string, required

## Request body

- object
  - `agent_name` string, required — (Required) Name of the agent
  - `introduction_and_objective` string, required — (Required) Introduction and objective of the agent
  - `response_guidelines` string, required — (Required) Guidelines for how the agent should respond
  - `task` string, required — (Required) The task the agent should perform
  - `faq` string — (Optional) FAQ content for the agent
  - `sample_conversations` string — (Optional) Example conversations for the agent. Use \n for newlines between turns.
  - `primary_language` 'en-US' | 'en-IN' | 'hi-IN' | 'ta-IN' | 'te-IN' | 'bn-IN' | 'mr-IN' | 'kn-IN' | 'ka-IN', required — (Required) Primary language locale for the agent
  - `secondary_language` 'en-US' | 'en-IN' | 'hi-IN' | 'ta-IN' | 'te-IN' | 'bn-IN' | 'mr-IN' | 'kn-IN' | 'ka-IN' — (Optional) Secondary language locale for the agent
  - `voice_id` string, uuid, required — (Required) Internal AgentVoice ID (UUID). Get available voices from the Get Assistant Voices endpoint.
  - `intro_message` string, required — (Required) Introduction message the agent will speak when the call starts
  - `agent_type` 'inbound' | 'outbound' | 'outbound_inbound' — (Required) Type of agent. Defaults to outbound.
  - `custom_variables` string[] — (Optional) Custom variables for the agent. For outbound agents, callee_name and mobile_number are always included automatically.

## Response `200`

Agent created successfully.

- object
  - `success` boolean
  - `data` object
    - `id` string — The unique ID of the created agent
    - `version` string — The version slug of the agent
    - `created_at` string, date-time
  - `message` string

## Other responses

- `400` — Bad Request - Invalid parameters or voice does not support the selected language.
- `401` — Unauthorized - Invalid or missing API key.

---

[API](https://skmtc.net/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.net/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/versions/00b614a7714c/schema)