---
title: "Create a category group"
method: POST
path: "/plans/{plan_id}/category_groups"
tags: ["Categories"]
---

# Create a category group

`POST /plans/{plan_id}/category_groups`

Creates a new category group

## Path parameters

- `plan_id` string, required

## Request body

- PostCategoryGroupWrapper
  - `category_group` SaveCategoryGroup, required
    - `name` string, required — The name of the category group. The name must be a maximum of 50 characters.

## Response `201`

The category group was successfully created

- SaveCategoryGroupResponse
  - `data` object, required
    - `category_group` CategoryGroup, required
      - `id` string, uuid, required
      - `name` string, required
      - `hidden` boolean, required — Whether or not the category group is hidden
      - `internal` boolean, required — Whether or not the category group is internal
      - `deleted` boolean, required — Whether or not the category group has been deleted. Deleted category groups will only be included in delta requests.
    - `server_knowledge` integer, required — The knowledge of the server

## Other responses

- `400` — The request could not be understood due to malformed syntax or validation error(s).

---

[API](https://skmtc.dev/ynab/apis/ynab-api-endpoints.md) · [All operations](https://skmtc.dev/ynab/apis/ynab-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ynab/ynab-api-endpoints/revisions/da7a78345b34/schema)