---
title: "Create Term"
method: POST
path: "/brand-terms/term-sets/{term_set_id}/terms"
tags: ["brandTerms"]
---

# Create Term

`POST /brand-terms/term-sets/{term_set_id}/terms`

Create terms that should be matched in the text. The term types are:

* **preferred**: this is the preferred term for the associated term set
* **prohibited**: this term should not be used to talk about the term set

## Path parameters

- `term_set_id` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- TermCreateRequest — Payload to create a new term for a term set.
  - `term` string, required
  - `type` 'preferred' | 'prohibited', required
  - `case_sensitive` boolean

## Response `201`

Successful Response

- TermResponse — DB-mapped representation of a term.
  - `id` string, uuid, required
  - `term` string, required
  - `type` 'preferred' | 'prohibited', required
  - `case_sensitive` boolean
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `created_by` string, nullable
  - `updated_by` string, nullable

## Other responses

- `401` — Authentication failed or no valid API key provided.
- `403` — Forbidden
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/markup/apis/api-reference.md) · [All operations](https://skmtc.dev/markup/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/markup/api-reference/revisions/65e1214d0bbf/schema)