Skip to main content
POST
/
v1
/
accounts
/
{accountId}
/
voice-library
Register a new voice in the voice library
curl --request POST \
  --url https://api.us.poly.ai/v1/accounts/{accountId}/voice-library \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "name": "<string>",
  "provider": "<string>",
  "config": {},
  "providerVoiceId": "<string>",
  "voiceMetadata": {}
}
'
{
  "voice": {
    "id": "<string>",
    "name": "<string>",
    "provider": "<string>",
    "providerVoiceId": "<string>",
    "config": {},
    "metadata": {},
    "isPolyVoice": false
  }
}

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
accountId
string
required

Body

application/json

Request schema for creating a new voice.

​
name
string
required

Human-readable voice name

​
provider
string
required

TTS provider (e.g. GOOGLE, OPENAI, ELEVENLABS)

​
config
object
required

Provider-specific voice config

​
providerVoiceId
string
required

Voice ID from the TTS provider

​
voiceMetadata
object

Additional voice metadata

Response

Successful response

Response for single voice endpoints.

​
voice
object
required

A single voice as returned by the public API.

Last modified on June 4, 2026