---
title: "Create Spoken Terms collection"
method: POST
path: "/v3/spoken-terms"
tags: ["ManageSpokenTerms"]
---

# Create Spoken Terms collection

`POST /v3/spoken-terms`

Create a new Spoken Terms collection with one or more term lists. Each term list contains terms for a single language.

## Request body

- CreateSpokenTermsParameters
  - `name` string, required — Name for the Spoken Terms collection.
  - `term_lists` SpokenTermsListInput[], required — Array of term lists, one per language.
    - `lang` string, required — Language code (ISO 639-1) for this term list.
    - `entries` string, required — Newline-separated list of terms. Maximum 300 characters total.

## Response `201`

Successfully created Spoken Terms collection.

- SpokenTerms
  - `spoken_terms_id` string — A unique ID assigned to the Spoken Terms collection.
  - `name` string — Name of the Spoken Terms collection.
  - `term_lists` SpokenTermsList[] — List of term lists contained in this collection.
    - `lang` string — Language code (ISO 639-1).
    - `entry_count` integer — Number of terms in this list.
  - `creation_time` string, date-time — The creation time of the Spoken Terms collection in ISO 8601-1:2019 format (e.g.: `2025-08-03T14:16:18.329Z`).

## Other responses

- `400` — Bad request. Please check error message and your parameters.
- `401` — Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `403` — Forbidden. Authorization failed or feature not available for your plan.
- `413` — The request size exceeds the limit.
- `415` — Unsupported Media Type. Must be application/json or application/x-www-form-urlencoded.
- `429` — Too many requests. Please wait and resend your request.
- `456` — Quota exceeded. Spoken Terms collection limit reached for your plan.

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) · [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepl/deepl-api-documentation/revisions/3c422fcc9c54/schema)