---
title: "Create Chatbot"
method: POST
path: "/api/external/chatbots"
---

# Create Chatbot

`POST /api/external/chatbots`

Create Chatbot

## Headers

- `x-api-key` string

## Request body

- object
  - `description` string
  - `is_public` boolean
  - `name` string
  - `personality_config` object
    - `style` string
    - `tone` string
  - `settings` object
    - `greeting` string
    - `isRequestUserInfoEnabled` boolean
    - `isToolEnabled` boolean
    - `model` string
    - `prompt` string
    - `snippet` object
      - `header` string
      - `logo` string
      - `name` string
      - `primaryColor` string
      - `secondaryColor` string
      - `slogan` string
  - `slug` string

## Response `201`

Example

- object
  - `chatbot` object
    - `active` boolean
    - `created_at` string
    - `description` string
    - `docs_metadata` unknown
    - `enabled_plugins` unknown
    - `id` string
    - `is_public` boolean
    - `managers` unknown
    - `migrated_data` boolean
    - `name` string
    - `openai_api_key` unknown
    - `organization_id` string
    - `personality_config` object
      - `style` string
      - `tone` string
    - `settings` object
      - `greeting` string
      - `isRequestUserInfoEnabled` boolean
      - `isToolEnabled` boolean
      - `model` string
      - `prompt` string
      - `snippet` object
        - `header` string
        - `logo` string
        - `name` string
        - `primaryColor` string
        - `secondaryColor` string
        - `slogan` string
    - `slug` string
    - `suggestions` unknown
    - `updated_at` string
    - `v1_chatbot_id` unknown
    - `version_id` unknown
    - `voice_widget_config` unknown
  - `message` string

## Changes

- **2025-01-22** `b8640ab9f7e0` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2025-01-22** `9a74b2d0931e` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`

[Change history](https://skmtc.dev/dasomx/apis/okchat2-0/changes/api/external/chatbots/post.md)

---

[API](https://skmtc.dev/dasomx/apis/okchat2-0.md) · [All operations](https://skmtc.dev/dasomx/apis/okchat2-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dasomx/okchat2-0/revisions/53c69266d405/schema)