---
title: "Create a category"
method: POST
path: "/categories"
tags: ["categories"]
---

# Create a category

`POST /categories`

This operation creates a category you can assign to a video for organization.

## Request body

- CategoryRequest
  - `category` object
    - `name` string — Name of the category.
    - `description` string — A description for the category.
    - `parent_id` string — Identifier to the parent category if one exists. If the category is on top level and no parent exists, the value is an empty string. **Example**: <code>"parent_id": ""</code> If the category is under an existing parent category, the value is the id of the parent category. **Example**: <code>"parent_id": "cb65a918-ad7d-406a-80d8-09c9c8d0dbb"</code> **Note**: When updating a category the parent can be removed by setting `parent_id` to an empty string.

## Response `200`

Success

- CategoryResponse
  - `category` object
    - `id` string — Unique identifier for the category.
    - `name` string — Name of the category.
    - `description` string — A description for the category.
    - `parent_id` string — Identifier to the parent category if one exists. If the category is on top level and no parent exists, the value is an empty string. **Example**: <code>"parent_id": ""</code> If the category is under an existing parent category, the value is the id of the parent category. **Example**: <code>"parent_id": "cb65a918-ad7d-406a-80d8-09c9c8d0dbb"</code> **Note**: When updating a category the parent can be removed by setting `parent_id` to an empty string.

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/revisions/157b6f741f2a/schema)