curl -X POST 'https://api.elevenlabs.io/v1/voices/add' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=example-name' \
  -F 'files=@sample.bin' \
  -F 'remove_background_noise=false' \
  -F 'description=example-description' \
  -F 'labels=[object Object]'

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

> Add 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' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=example-name' \
  -F 'files=@sample.bin'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | The name that identifies this voice.... |
| files | body | string[] | Yes | A list of file paths to audio recordi... |
| remove_background_noise | body | boolean | No | If set will remove background noise f... |
Other params: description, labels

## Response (200 OK)
{"requires_verification":false,"voice_id":"c38kUX8pkfYO2kHyqfFy"}

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

POST

POST /v1/voices/add — ElevenLabs API

ElevenLabs API

Add 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
→ 218 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' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -F 'name=example-name' \  -F '[email protected]' \  -F 'remove_background_noise=false' \  -F 'description=example-description' \  -F 'labels=[object Object]'

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	The name that identifies this voice. This will be displayed in the dropdown of the website.
files	body	string[]	Yes	A list of file paths to audio recordings intended for voice cloning.
remove_background_noise	body	boolean	No	If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse.
description	body	string	No	A description of the voice.
labels	body	object	No	Labels for the voice. Keys can be language, accent, gender, or age.

Response 200 OK

{
  "requires_verification": false,
  "voice_id": "c38kUX8pkfYO2kHyqfFy"
}

Get a free ElevenLabs API key → sponsored

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