---
title: "Create Pronunciation Dictionary"
method: POST
path: "/v2/pronunciation-dictionaries"
tags: ["Pronunciation Dictionaries"]
---

# Create Pronunciation Dictionary

`POST /v2/pronunciation-dictionaries`

Create a [pronunciation dictionary](/sections/conversational-video-interface/pal/pronunciation-dictionaries) with custom rules for controlling how words are spoken. Rules are automatically synced to both Cartesia and ElevenLabs so they work regardless of which TTS engine your PAL uses.

## Request body

- object
  - `name` string, required — Name of the pronunciation dictionary. Max 255 characters.
  - `rules` object[] — List of pronunciation rules. Duplicate `text` values are not allowed. You can omit rules at creation and add them later via [Update Pronunciation Dictionary](/api-reference/pronunciation-dictionaries/update-pronunciation-dictionary).
    - `text` string, required — The word or phrase to match. Max 200 characters.
    - `pronunciation` string, required — How the text should be pronounced. For `alias` type, this is the replacement text. For `ipa` type, this is an IPA string (raw or pipe-delimited). Max 500 characters.
    - `type` 'alias' | 'ipa', required — Rule type. One of `alias` or `ipa`.
    - `case_sensitive` boolean — Whether matching is case-sensitive.
    - `word_boundaries` boolean — Whether to match only whole words.

## Response `201`

Pronunciation dictionary created successfully

- object
  - `pronunciation_dictionary_id` string — Unique identifier for the pronunciation dictionary.
  - `name` string — Name of the pronunciation dictionary.
  - `rules` object[] — List of pronunciation rules.
    - `text` string
    - `pronunciation` string
    - `type` 'alias' | 'ipa'
    - `case_sensitive` boolean
    - `word_boundaries` boolean
  - `rules_count` integer — Number of rules in the dictionary.
  - `created_at` string — ISO 8601 timestamp of when the dictionary was created.
  - `updated_at` string — ISO 8601 timestamp of when the dictionary was last updated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)