---
title: "Create Pronunciation Dictionaries"
method: POST
path: "/v1/studio/projects/{project_id}/pronunciation-dictionaries"
tags: ["studio"]
---

# Create Pronunciation Dictionaries

`POST /v1/studio/projects/{project_id}/pronunciation-dictionaries`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/studio/projects/{project_id}/pronunciation-dictionaries`
- Auth: none declared

Create a set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does.

## Path parameters

- `project_id` string, required: The ID of the Studio project.

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyCreatePronunciationDictionariesV1StudioProjectsProjectIdPronunciationDictionariesPost
  - `pronunciation_dictionary_locators` PronunciationDictionaryVersionLocatorDBModel[], required: A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"Vmd4Zor6fplcA7WrINey\",\"version_id\":\"hRPaxjlTdR7wFMhV4w0b\"}"' --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"JzWtcGQMJ6bnlWwyMo7e\",\"version_id\":\"lbmwxiLu4q6txYxgdZqn\"}"'.
    - `pronunciation_dictionary_id` string, required
    - `version_id` string, nullable, required
  - `invalidate_affected_text` boolean: This will automatically mark text in this project for reconversion when the new dictionary applies or the old one no longer does.

## Response `200`

Successful Response

- CreatePronunciationDictionaryResponseModel
  - `status` string, required: The status of the create pronunciation dictionary request. If the request was successful, the status will be 'ok'. Otherwise an error message with status 500 will be returned.

## Other responses

- `422`: Validation Error

## Changes

- **2026-02-08** `5b595807512c`: 1 info
  - api operation id `Create_Pronunciation_Dictionaries_v1_studio_projects__project_id__pronunciation_dictionaries_post` removed and replaced with `update_pronunciation_dictionaries`
- **2025-05-16** `503db4198a44`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/studio/projects/:project_id/pronunciation-dictionaries/post.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)