---
title: "Create Custom Voice"
api: "POST /v1/api/voices"
description: "Create a custom voice using a voice embedding."
---

## Headers
<ParamField header="x-workspace-id" type="string" required>
Workspace identifier for the API.
</ParamField>

## Request Body

<ParamField body="name" type="string" required>
Name for the custom voice.
</ParamField>

<ParamField body="description" type="string">
Description of the custom voice.
</ParamField>

<ParamField body="embedding" type="object" required>
Voice embedding object generated from voice cloning.
</ParamField>

<ParamField body="language" type="string">
Language code for the voice (e.g., "en").
</ParamField>

## Response Fields

<ResponseField name="_id" type="string">
Unique identifier for the custom voice.
</ResponseField>

<ResponseField name="name" type="string">
Name of the custom voice.
</ResponseField>

<ResponseField name="description" type="string">
Description of the custom voice.
</ResponseField>

<ResponseField name="workspaceId" type="string">
Workspace that owns the custom voice.
</ResponseField>

<ResponseField name="createdAt" type="string">
Timestamp when the voice was created.
</ResponseField>

<ResponseExample>
```json
{
  "_id": "665a1b2c3d4e5f6a7b8c9d0e",
  "name": "Custom Sales Voice",
  "description": "Professional sales voice",
  "language": "en",
  "workspaceId": "664a1b2c3d4e5f6a7b8c9d0e",
  "createdAt": "2024-06-01T09:00:00.000Z"
}
```
</ResponseExample>