Sign in

v28

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-05-2887246443.7 KB

Add a community voice to the voice library

post/add-community-voice

Request body

voice_provider'elevenlabs' | 'cartesia' | 'minimax' | 'fish_audio'

Voice provider to add the voice from.

provider_voice_idstring required

Voice id assigned by the provider.

voice_namestring required

A custom name for the voice.

public_user_idstring

Required for ElevenLabs only. User id of the voice owner.

Response

Community voice added successfully

voice_idstring required

Unique id for the voice.

voice_namestring required

Name of the voice.

provider'elevenlabs' | 'openai' | 'cartesia' | 'minimax' | 'fish_audio' | 'platform' required

Indicates the provider of voice.

accentstring

Accent annotation of the voice.

gender'male' | 'female' required

Gender of voice.

agestring

Age annotation of the voice.

preview_audio_urlstring

URL to the preview audio of the voice.

Example response

{
  "voice_id": "retell-Cimo",
  "voice_name": "Adrian",
  "provider": "elevenlabs",
  "accent": "American",
  "gender": "male",
  "age": "Young",
  "preview_audio_url": "https://retell-utils-public.s3.us-west-2.amazonaws.com/adrian.mp3"
}