---
title: "Create a new category"
method: POST
path: "/categories/{teamId}"
tags: ["Categories"]
---

# Create a new category

`POST /categories/{teamId}`

Sample Request:
            
    POST /categories/cbb70402-1359-477f-ac92-0171cf2b5ff7
    {
        "name": "Water",
        "imageName": "water.svg",
        "color": "#0000cc",
        "keywordMatching": "Any",
        "keywords": [
            {
                "value": "H2O"
            },
            {
                "value": "Water"
            }
        ]
    }

## Path parameters

- `teamId` string, required

## Request body

- CategoryDetails
  - `id` string, nullable
  - `teamId` string, nullable
  - `isDefault` boolean
  - `options` 0 | 1 | 2 | 4 | 8
  - `name` string, required
  - `color` string, required
  - `imageName` string, required
  - `keywords` string[], required
  - `keywordsExcluded` string[], nullable
  - `keywordMatching` 0 | 1, required
  - `augmentations` CategoryAugmentationDetails[], nullable
    - `enabled` boolean
    - `name` string, nullable
    - `type` 0 | 1 | 2 | 3, required
    - `value` string, nullable
    - `id` string, nullable
    - `parameters` Parameter[], nullable
      - `id` string, nullable
      - `name` string, nullable
      - `operation` Operation
        - `type` 0 | 1 | 2 | 3 | 4
        - `arguments` Argument[], nullable
          - `value` string, nullable
          - `order` integer
      - `defaultValue` string, nullable
      - `eventSourceId` string, nullable
  - `enrichments` CategoryEnrichmentDetails[], nullable
    - `id` string, nullable
    - `name` string, nullable
    - `type` 0 | 1, required
    - `value` string, nullable
  - `order` integer

## Response `201`

Returns the newly created category

- CategoryDetails
  - `id` string, nullable
  - `teamId` string, nullable
  - `isDefault` boolean
  - `options` 0 | 1 | 2 | 4 | 8
  - `name` string, required
  - `color` string, required
  - `imageName` string, required
  - `keywords` string[], required
  - `keywordsExcluded` string[], nullable
  - `keywordMatching` 0 | 1, required
  - `augmentations` CategoryAugmentationDetails[], nullable
    - `enabled` boolean
    - `name` string, nullable
    - `type` 0 | 1 | 2 | 3, required
    - `value` string, nullable
    - `id` string, nullable
    - `parameters` Parameter[], nullable
      - `id` string, nullable
      - `name` string, nullable
      - `operation` Operation
        - `type` 0 | 1 | 2 | 3 | 4
        - `arguments` Argument[], nullable
          - `value` string, nullable
          - `order` integer
      - `defaultValue` string, nullable
      - `eventSourceId` string, nullable
  - `enrichments` CategoryEnrichmentDetails[], nullable
    - `id` string, nullable
    - `name` string, nullable
    - `type` 0 | 1, required
    - `value` string, nullable
  - `order` integer

## Other responses

- `400` — If the input is not valid
- `403` — If you have no permission to access this resource
- `404` — If the resource was not found
- `500` — If any server side errors occur

---

[API](https://skmtc.net/signl4/apis/signl4-api-v1.md) · [All operations](https://skmtc.net/signl4/apis/signl4-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signl4/signl4-api-v1/versions/ddbe216a9287/schema)