---
title: "Create blocklist term"
method: POST
path: "/glossary-api/v3/accounts/{accountUid}/blocklists/{blocklistUid}/terms"
tags: ["Blocklist API"]
---

# Create blocklist term

`POST /glossary-api/v3/accounts/{accountUid}/blocklists/{blocklistUid}/terms`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/glossary-api/v3/accounts/{accountUid}/blocklists/{blocklistUid}/terms`
- Auth: HTTP bearer

Create blocklist term endpoint.

## Path parameters

- `accountUid` string, required
- `blocklistUid` string, uuid, required

## Request body

- BlocklistTermCommandPTO: Blocklist term command.
  - `term` string, required: Blocklist term. Max term length is equal to 250 characters.
  - `note` string: Notes / description of the term. Max note length is equal to 1500 characters.
  - `caseSensitive` boolean: Term caseSensitive.
  - `exactMatch` boolean: Term exactMatch.
  - `variants` string[]: Term synonyms/variations. Max length of single variation entry is 250 characters. Max amount of variations in current array is 50.
  - `preferredTerms` string[]: Possible terms to be used instead of blocked. Max length of single variation entry is 250 characters. Max amount of variations in current array is 50.
  - `localeIds` LocaleId[]: Associated locale identifiers.

## Response `200`

- BlocklistTermResponsePTO
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` BlocklistTermResponse: Blocklist term response.
      - `termUid` string: Blocklist term uid.
      - `blocklistUid` string: Blocklist uid.
      - `term` string: Blocked term itself.
      - `note` string: Notes/ description of the term.
      - `caseSensitive` boolean: Blocklist term caseSensitive property.
      - `exactMatch` boolean: Blocklist term exactMatch property.
      - `variants` string[]: Term variants/synonyms.
      - `preferredTerms` string[]: Suggested terms to be used instead of current.
      - `localeIds` LocaleId[]: Associated locale identifiers.
      - `archived` boolean: Archived flag.
      - `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.

## 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`: 1 breaking, 4 warning, 3 info
  - the response's body type changed from no type to `object` for status `200`
  - the `preferredTerms/items/` request property's maxLength was set to `250`
  - the `term` request property's maxLength was set to `250`
  - the `variants/items/` request property's maxLength was set to `250`
  - …4 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/blocklists/:blocklistUid/terms/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)