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

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

> Create Url Document

## 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/url' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"string","name":"string"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| url | body | string | Yes | URL to a page of documentation that t... |
| name | body | string | No | A custom, human-readable name for the... |
| parent_folder_id | body | string | No | If set, the created document or folde... |

## 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/url

ElevenLabs API

Create Url Document

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
→ 215 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/url' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "url": "string",  "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
url	body	string	Yes	URL to a page of documentation that the agent will have access to in order to interact with users.
name	body	string	No	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 document is 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"
    }
  ]
}