---
title: "Add A Pronunciation Dictionary"
method: POST
path: "/v1/pronunciation-dictionaries/add-from-file"
tags: ["Pronunciation Dictionary"]
---

# Add A Pronunciation Dictionary

`POST /v1/pronunciation-dictionaries/add-from-file`

## 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/pronunciation-dictionaries/add-from-file`
- Auth: none declared

Creates a new pronunciation dictionary from a lexicon .PLS file

## 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 `multipart/form-data`

- BodyAddAPronunciationDictionaryV1PronunciationDictionariesAddFromFilePost
  - `name` string, required: The name of the pronunciation dictionary, used for identification only.
  - `file` string, binary, nullable: A lexicon .pls file which we will use to initialize the project with.
  - `description` string, nullable: A description of the pronunciation dictionary, used for identification only.
  - `workspace_access` 'admin' | 'editor' | 'commenter' | 'viewer', nullable: Should be one of 'admin', 'editor' or 'viewer'. If not provided, defaults to no access.

## Response `200`

Successful Response

- AddPronunciationDictionaryResponseModel
  - `id` string, required: The ID of the created pronunciation dictionary.
  - `name` string, required: The name of the created pronunciation dictionary.
  - `created_by` string, required: The user ID of the creator of the pronunciation dictionary.
  - `creation_time_unix` integer, required: The creation time of the pronunciation dictionary in Unix timestamp.
  - `version_id` string, required: The ID of the created pronunciation dictionary version.
  - `version_rules_num` integer, required: The number of rules in the version of the pronunciation dictionary.
  - `description` string, nullable: The description of the pronunciation dictionary.
  - `permission_on_resource` 'admin' | 'editor' | 'commenter' | 'viewer', nullable, required: The permission on the resource of the pronunciation dictionary.

## Other responses

- `422`: Validation Error

## Changes

- **2026-02-08** `5b595807512c`: 1 warning, 2 info
  - added the new `commenter` enum value to the `permission_on_resource/anyOf[subschema #1]/` response property for the response status `200`
  - api operation id `Add_a_pronunciation_dictionary_v1_pronunciation_dictionaries_add_from_file_post` removed and replaced with `add_from_file`
  - added the new `commenter` enum value to the request property `workspace_access/anyOf[subschema #1]/`
- **2025-05-16** `503db4198a44`: 4 breaking, 7 info
  - removed the enum value `admin` of the request property `workspace_access`
  - removed the enum value `editor` of the request property `workspace_access`
  - removed the enum value `viewer` of the request property `workspace_access`
  - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …7 more
- **2024-05-07** `c1dd2ce19be9`: 1 info
  - added the new optional request property `workspace_access`
- **2023-11-25** `659035dd9081`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/pronunciation-dictionaries/add-from-file/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/0e2bfc751634?raw)