curl -X POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/folder' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "parent_folder_id": "string",
  "enable_auto_sync": false,
  "auto_remove": false,
  "minimum_frequency_days": 0
}'

# POST /v1/convai/knowledge-base/folder (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Create Folder

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/folder' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","parent_folder_id":"string"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | A custom, human-readable name for the... |
| parent_folder_id | body | string | No | If set, the created document or folde... |
| enable_auto_sync | body | boolean | No | Whether to enable auto-sync for this... |

## Response (200 OK)
{"id":"string","name":"string","folder_path":[{"id":"string"}]}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

/v1/convai/knowledge-base/folder

ElevenLabs API

Create Folder

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 211 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/convai/knowledge-base/folder' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "parent_folder_id": "string",  "enable_auto_sync": false,  "auto_remove": false,  "minimum_frequency_days": 0}'

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	A custom, human-readable name for the document.
parent_folder_id	body	string	No	If set, the created document or folder will be placed inside the given folder.
enable_auto_sync	body	boolean	No	Whether to enable auto-sync for this URL document.
auto_remove	body	boolean	No	Whether to automatically remove the document if the URL becomes unavailable. Only applicable when auto-sync is enabled.
minimum_frequency_days	body	integer	No	Minimum frequency (in days) at which the underlying eligible documents are refreshed. The actual interval may be shorter, never longer. Defaults to 7, tightened to the parent folder's frequency if that is stricter. Only applicable when auto-sync is enabled.

Response 200 OK

{
  "id": "string",
  "name": "string",
  "folder_path": [
    {
      "id": "string"
    }
  ]
}