---
title: "Create a new category"
method: POST
path: "/categories"
---

# Create a new category

`POST /categories`

## Request body

- CategoryInput
  - `name` string, required
  - `description` string
  - `status` string

## Response `201`

Created

- Category
  - `_id` string
  - `groupid` string
  - `name` string
  - `description` string
  - `status` string
  - `subcategories` Subcategory[]
    - `_id` string
    - `group_id` string
    - `category` string
    - `code` string
    - `name` string
    - `description` string
    - `status` string
    - `teams` string[]
    - `mapping_id` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `__v` number
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `__v` number

---

[API](https://skmtc.dev/boyahq/apis/boya-categories-api.md) · [All operations](https://skmtc.dev/boyahq/apis/boya-categories-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/boyahq/boya-categories-api/revisions/617707efafe8/schema)