---
title: "createTaxonomyClassification"
method: POST
path: "/v2/entity/taxonomies/classifications"
tags: ["Taxonomy"]
---

# createTaxonomyClassification

`POST /v2/entity/taxonomies/classifications`

Create a new classification for a taxonomy

## Request body

- TaxonomyClassification
  - `id` string
  - `slug` string, required — URL-friendly identifier for the classification
  - `name` string, required
  - `parents` ClassificationId[]
  - `color` string — Color of the classification
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `archived` boolean — Archived classification are not visible in the UI
  - `starred` boolean — Starred taxonomy classifications can represent "favorites" or commonly used classifications
  - `enabled_locations` union[] — List of locations where the classification is enabled to be used. If empty, it's enabled for all locations.
    - union
      - 'account' | 'contact' | 'contract' | 'email_template' | 'file' | 'journey' | 'meter_counter' | 'meter' | 'opportunity' | 'order' | 'partner' | 'price' | 'product' | 'submission' | 'tax' | 'message' | 'portal_user' | 'request' | 'comment' | 'user'
      - string
  - `enabled_purposes` string[] — List of purpose slugs where the classification is enabled to be used. If empty, it's enabled for all purposes.
  - `_manifest` string[], nullable — Manifest ID used to create/update the taxonomy classification

## Response `201`

Created taxonomy classification

- TaxonomyClassification
  - `id` string
  - `slug` string, required — URL-friendly identifier for the classification
  - `name` string, required
  - `parents` ClassificationId[]
  - `color` string — Color of the classification
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `archived` boolean — Archived classification are not visible in the UI
  - `starred` boolean — Starred taxonomy classifications can represent "favorites" or commonly used classifications
  - `enabled_locations` union[] — List of locations where the classification is enabled to be used. If empty, it's enabled for all locations.
    - union
      - 'account' | 'contact' | 'contract' | 'email_template' | 'file' | 'journey' | 'meter_counter' | 'meter' | 'opportunity' | 'order' | 'partner' | 'price' | 'product' | 'submission' | 'tax' | 'message' | 'portal_user' | 'request' | 'comment' | 'user'
      - string
  - `enabled_purposes` string[] — List of purpose slugs where the classification is enabled to be used. If empty, it's enabled for all purposes.
  - `_manifest` string[], nullable — Manifest ID used to create/update the taxonomy classification

## Other responses

- `409` — Taxonomy classification already exists
- `429` — Too many requests

---

[API](https://skmtc.net/epilot/apis/entity-api.md) · [All operations](https://skmtc.net/epilot/apis/entity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/entity-api/revisions/3020984570dc/schema)