curl -X POST 'https://api.elevenlabs.io/v1/convai/secrets' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "example-type",
  "name": "example-name",
  "value": "example-value"
}'

# POST /v1/convai/secrets (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> Create Convai Workspace Secret

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

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| type | body | string | Yes | Request body field type. |
| name | body | string | Yes | Request body field name. |
| value | body | string | Yes | Request body field value. |

## Response (200 OK)
{"type":"string","secret_id":"string","name":"string"}

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

POST

POST /v1/convai/secrets — ElevenLabs API

ElevenLabs API

Create Convai Workspace Secret

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

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 205 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/secrets' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "type": "example-type",  "name": "example-name",  "value": "example-value"}'

Parameters

Name	In	Type	Required	Description
type	body	string	Yes	Request body field type.
name	body	string	Yes	Request body field name.
value	body	string	Yes	Request body field value.

Response 200 OK

{
  "type": "string",
  "secret_id": "string",
  "name": "string"
}

Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.