curl -X POST 'https://api.elevenlabs.io/v1/voices/add/public-user-id/voice-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "new_name": "example-new-name",
  "bookmarked": true
}'

# POST /v1/voices/add/{public_user_id}/{voice_id} (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> Add Shared Voice

## 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/voices/add/public-user-id/voice-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"new_name":"example-new-name","bookmarked":true}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| public_user_id | path | string | Yes | Public user ID used to publicly ident... |
| voice_id | path | string | Yes | Voice ID to be used, you can use http... |
| new_name | body | string | Yes | The name that identifies this voice.... |
Other params: bookmarked

## Response (200 OK)
{"voice_id":"b38kUX8pkfYO2kHyqfFy"}

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

POST

POST /v1/voices/add/{public_user_id}/{voice_id} — ElevenLabs API

ElevenLabs API

Add Shared Voice

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
→ 220 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/voices/add/public-user-id/voice-id' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "new_name": "example-new-name",  "bookmarked": true}'

Parameters

Name	In	Type	Required	Description
public_user_id	path	string	Yes	Public user ID used to publicly identify ElevenLabs users.
voice_id	path	string	Yes	Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.
new_name	body	string	Yes	The name that identifies this voice. This will be displayed in the dropdown of the website.
bookmarked	body	boolean	No	Request body field bookmarked.

Response 200 OK

{
  "voice_id": "b38kUX8pkfYO2kHyqfFy"
}

Get a free ElevenLabs API key → sponsored

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