---
title: "Create Folder"
method: POST
path: "/v1/convai/knowledge-base/folder"
tags: ["Conversational AI"]
---

# Create Folder

`POST /v1/convai/knowledge-base/folder`

Create a folder used for grouping documents together.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyCreateFolderV1ConvaiKnowledgeBaseFolderPost
  - `name` string, required — A custom, human-readable name for the document.
  - `parent_folder_id` string, nullable — If set, the created document or folder will be placed inside the given folder.
  - `enable_auto_sync` boolean — Whether to enable auto-sync for this URL document.
  - `auto_remove` boolean — Whether to automatically remove the document if the URL becomes unavailable. Only applicable when auto-sync is enabled.

## Response `200`

Successful Response

- AddKnowledgeBaseResponseModel
  - `id` string, required
  - `name` string, required
  - `folder_path` KnowledgeBaseFolderPathSegmentSummaryResponseModel[] — The folder path segments leading to this entity, from root to parent folder.
    - `id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/6c2d6eb4a7e6/schema)