---
title: "Create glossary entry"
method: POST
path: "/glossary-api/v3/accounts/{accountUid}/glossaries/{glossaryUid}/entries"
tags: ["Glossary API"]
---

# Create glossary entry

`POST /glossary-api/v3/accounts/{accountUid}/glossaries/{glossaryUid}/entries`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/glossary-api/v3/accounts/{accountUid}/glossaries/{glossaryUid}/entries`
- Auth: HTTP bearer

Create glossary entry endpoint.

## Path parameters

- `accountUid` string, required
- `glossaryUid` string, uuid, required

## Request body

- GlossaryEntryCommandPTO
  - `definition` string: Glossary entry definition. Max definition length is equal to 1500 characters.
  - `partOfSpeech` 'NOUN' | 'VERB' | 'ADJECTIVE' | 'ADVERB' | 'PRONOUN' | 'PREPOSITION' | 'INTERJECTION' | 'CONJUNCTION' | 'PROPER_NOUN': Glossary entry part of speech. Accepts both uppercase enum constants and human-readable formats (case-insensitive). Supported values: - NOUN / Noun - VERB / Verb - ADJECTIVE / Adjective - ADVERB / Adverb - PRONOUN / Pronoun - PREPOSITION / Preposition - INTERJECTION / Interjection - CONJUNCTION / Conjunction - PROPER_NOUN / "Proper Noun"
  - `labelUids` string[]: Glossary label uid to be associated.
  - `skipMissingTranslations` boolean: When set to `true`, any missing translations in the request will be ignored during a glossary entry update — they will neither be deleted nor modified. If `false` (default), missing translations may be removed or updated to reflect the provided data.
  - `translations` GlossaryEntryTranslationCommandPTO[], required: Glossary entry translations. Please note: - translations that were not passed into the current array but present ( update call ) will be removed (as example we may consider search by filter which may return translations only for specified locales); - each translation from the array should at least has not empty term or notes field, or disabled property marked as 'true', otherwise 'validation error' ( code : 400 ) will be returned.
    - `localeId` string: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
    - `term` string: Translation term. Max term length is equal to 250 characters.
    - `notes` string: Translation notes. Max notes length is equal to 1500 characters.
    - `caseSensitive` boolean: Translation caseSensitive.
    - `exactMatch` boolean: Translation exactMatch.
    - `doNotTranslate` boolean: Translation doNotTranslate.
    - `disabled` boolean: Translation disabled.
    - `variants` string[]: Translation synonyms/variations. Max length of single variation entry is 250 characters. Max amount of variations in current array is 50.
    - `customFieldValues` CustomFieldValuesCommandPTO[]: Translation assigned custom fields values.
      - `fieldUid` string, required: Uid of the custom-field. That is associated with the glossary entry.
      - `fieldValue` string: Field value to be assigned. NOTE: Please note that validation will be performed based on field-type. Field-type is external property in scope of 'glossary service', and may be retrieved using 'custom-fields-service'.
  - `customFieldValues` CustomFieldValuesCommandPTO[]: Assigned custom field values.
    - `fieldUid` string, required: Uid of the custom-field. That is associated with the glossary entry.
    - `fieldValue` string: Field value to be assigned. NOTE: Please note that validation will be performed based on field-type. Field-type is external property in scope of 'glossary service', and may be retrieved using 'custom-fields-service'.
  - `suggestion` boolean: Create the entry as a suggestion (`suggestionStatus` SUGGESTED) instead of a standard entry.

## Response `200`

- GlossaryEntryDetailedResponsePTO
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` GlossaryEntryDetailedResponse: Glossary entry response. Which provides translation request details in extended form.
      - `entryUid` string: Glossary entry uid.
      - `glossaryUid` string: Glossary uid.
      - `definition` string: Glossary entry definition.
      - `partOfSpeech` string: Glossary entry part of speech value.
      - `labelUids` string[]: Assigned label uuids.
      - `translations` GlossaryEntryTranslationPTO[]: Translations collection.
        - `localeId` string: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
        - `fallbackLocaleId` string: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
        - `term` string: Glossary translation term.
        - `notes` string: Glossary translation notes.
        - `caseSensitive` boolean: Glossary entry translation caseSensitive property.
        - `exactMatch` boolean: Glossary entry translation exactMatch property.
        - `doNotTranslate` boolean: Glossary entry translation doNotTranslate property.
        - `disabled` boolean: Glossary entry translation disabled property.
        - `variants` string[]: Term variants/synonyms.
        - `customFieldValues` EntryTranslationCustomFieldValuePTO[]: Translation level, assigned custom fields values.
          - `fieldUid` string: Custom field uid.
          - `fieldName` string: Custom field name.
          - `fieldValue` string: Custom field value.
          - `localeId` string: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
        - `requestTranslationStatus` EntryTranslationInProgressPTO: Holds meta-information about translation that is in progress.
          - `localeId` string: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
          - `requestDateTime` string, date-time: ISO 8601 UTC timestamp.
          - `requestUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `createdByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `modifiedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
        - `createdDate` string, date-time: ISO 8601 UTC timestamp.
        - `modifiedDate` string, date-time: ISO 8601 UTC timestamp.
      - `customFieldValues` EntryCustomFieldValuePTO[]: Assigned custom field values.
        - `fieldUid` string: Custom field uid.
        - `fieldName` string: Custom field name.
        - `fieldValue` string: Custom field value.
      - `archived` boolean: Archived flag.
      - `mtOptimizedLabel` 'Not MT-Compatible' | 'MT-Compatible' | 'MT-Compatibility pending': MT-compatibility state of the entry.
      - `suggestionStatus` 'SUGGESTED' | 'APPROVED': Suggestion status of the entry. Omitted for standard (non-suggested) entries.
      - `createdByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
      - `modifiedByUserUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
      - `createdDate` string, date-time: ISO 8601 UTC timestamp.
      - `modifiedDate` string, date-time: ISO 8601 UTC timestamp.
      - `requestTranslationStatuses` object: Request translation details in detailed form. Please note that translation locale id will be used as a key.

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `403`: Access denied.
- `404`: Resource not found.
- `429`: Too many simultaneous API requests.
- `500`: Unexpected error.

## Changes

- **2026-10-26** `0da6569bfcb7`: 3 breaking, 4 warning, 3 info
  - the request property `translations` became required
  - the `translations` request property's minItems was increased to `1`
  - the response's body type changed from no type to `object` for status `200`
  - the `definition` request property's maxLength was set to `1500`
  - …6 more
- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/glossary-api/v3/accounts/:accountUid/glossaries/:glossaryUid/entries/post.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)