---
title: "POST /add-community-voice"
method: POST
path: "/add-community-voice"
---

# POST /add-community-voice

`POST /add-community-voice`

Add a community voice to the voice library

## Request body

- object
  - `voice_provider` 'elevenlabs' | 'cartesia' | 'minimax' | 'fish_audio' — Voice provider to add the voice from.
  - `provider_voice_id` string, required — Voice id assigned by the provider.
  - `voice_name` string, required — A custom name for the voice.
  - `public_user_id` string — Required for ElevenLabs only. User id of the voice owner.

## Response `200`

Community voice added successfully

- VoiceResponse
  - `voice_id` string, required — Unique id for the voice.
  - `voice_name` string, required — Name of the voice.
  - `provider` 'elevenlabs' | 'openai' | 'cartesia' | 'minimax' | 'fish_audio' | 'platform', required — Indicates the provider of voice.
  - `accent` string — Accent annotation of the voice.
  - `gender` 'male' | 'female', required — Gender of voice.
  - `age` string — Age annotation of the voice.
  - `preview_audio_url` string — URL to the preview audio of the voice.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/retellai/apis/retell-sdk.md) · [All operations](https://skmtc.net/retellai/apis/retell-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/retellai/retell-sdk/revisions/2a182bedbfc5/schema)