---
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

## Changes

- **2026-08-14** `617707efafe8` — 2 breaking, 7 info
  - the `__v` response's property type changed from `integer` to `number` for status `201`
  - the `subcategories/items/__v` response's property type changed from `integer` to `number` for status `201`
  - added the new optional request property `status`
  - removed the non-success response with the status `400`
  - …5 more

[Change history](https://skmtc.dev/boyahq/apis/boya-categories-api/changes/categories/post.md)

---

[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)