> ## Documentation Index
> Fetch the complete documentation index at: https://botsify.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Bot — Add a New Chatbot or AI Agent in Botsify

> Create a new chatbot, AI agent, or voice bot in your Botsify workspace. Provide a name, agent type, and optional template to get started.

Create a new bot in your Botsify workspace by specifying a name and the type of agent you want to build. You can optionally base the bot on a pre-built template to get started quickly. The response includes the new bot's unique ID and API key, which you will use in subsequent calls.

## Request

**bot\_name** `string` *required*

The display name for your new bot. This name appears in your Botsify workspace dashboard.

**agent\_type** `string` *required*

The type of agent to create. Accepted values:

* `chatbot` — a standard rule-based or AI-powered chat agent
* `agent` — an autonomous AI agent capable of multi-step reasoning
* `voice` — a voice-enabled bot for telephony or voice interfaces

**template** `string`

An optional pre-built template slug to initialise the bot with a pre-configured set of flows, responses, and settings.

## Example

```bash theme={null}
curl --request POST \
  --url https://app.botsify.com/api/v1/create-bot \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "bot_name": "Support agent",
    "agent_type": "agent"
  }'
```

## Response

A successful `200 OK` response returns a JSON object with the newly created bot's identifiers.

| Field | Type | Description |
| - | - | - |
| `bot_id` | string | The unique identifier for the new bot. |
| `api_key` | string | The bot-level API key used to send queries and manage the bot. |
| `bot_name` | string | The name you provided at creation time. |

```json theme={null}
{
  "bot_id": "12345",
  "api_key": "bfy_live_xxxxxxxxxxxx",
  "bot_name": "Support agent"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.