Skip to main content
POST
/
v3
/
spoken-terms
Create Spoken Terms collection
curl --request POST \
  --url https://api.deepl.com/v3/spoken-terms \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Technical Terms",
  "term_lists": [
    {
      "lang": "en",
      "entries": "DeepL\nAPI\nwebhook"
    }
  ]
}
'
{
  "spoken_terms_id": "def3a26b-3e84-45b3-84ae-0c0aaf3525f7",
  "name": "Technical Terms",
  "term_lists": [
    {
      "lang": "en",
      "entry_count": 3
    }
  ],
  "creation_time": "2025-08-03T14:16:18.329Z"
}
{
  "message": "Bad request"
}
{
  "message": "<string>",
  "code": "invalid_content_type"
}
{
  "message": "Forbidden. Authorization failed or feature not available for your plan."
}
{
  "message": "<string>",
  "code": "invalid_content_type"
}
{
  "message": "Unsupported Content-Type"
}
{
  "message": "<string>",
  "code": "invalid_content_type"
}
{
  "message": "Spoken Terms quota exhausted"
}

Authorizations

​
Authorization
string
header
default:DeepL-Auth-Key
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Body

​
name
string
required

Name for the Spoken Terms collection.

Maximum string length: 1024
Example:

"Technical Terms"

​
term_lists
object[]
required

Array of term lists, one per language.

Response

Successfully created Spoken Terms collection.

​
spoken_terms_id
string

A unique ID assigned to the Spoken Terms collection.

Example:

"def3a26b-3e84-45b3-84ae-0c0aaf3525f7"

​
name
string

Name of the Spoken Terms collection.

Example:

"Technical Terms"

​
term_lists
object[]

List of term lists contained in this collection.

​
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).

Example:

"2025-08-03T14:16:18.329Z"