---
title: "Changes to Create a category"
method: POST
path: "/plans/{plan_id}/categories"
---

# Changes to Create a category

`POST /plans/{plan_id}/categories`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 12 revisions.

- **2026-07-12** `2220c3a168a3`: 2 info
- **2026-05-03** `1e4aa027827c`: 9 breaking, 18 warning, 2 info
- **2026-04-01** `60411c83c141`: 1 info

## Changes

- **2026-07-12** `2220c3a168a3`: 2 info
  - added the new optional request property `category/allOf[#/components/schemas/SaveCategory]/goal_frequency`
  - added the required property `data/category/allOf[#/components/schemas/CategoryBase]/internal` to the response with the `201` status
- **2026-05-03** `1e4aa027827c`: 9 breaking, 18 warning, 2 info
  - the `data/category` response's property type changed from `object` to no type for status `201`
  - removed the required property `data/category/activity` from the response with the `201` status
  - removed the required property `data/category/balance` from the response with the `201` status
  - removed the required property `data/category/budgeted` from the response with the `201` status
  - removed the required property `data/category/category_group_id` from the response with the `201` status
  - removed the required property `data/category/deleted` from the response with the `201` status
  - removed the required property `data/category/hidden` from the response with the `201` status
  - removed the required property `data/category/id` from the response with the `201` status
  - removed the required property `data/category/name` from the response with the `201` status
  - removed the optional property `data/category/category_group_name` from the response with the `201` status
  - removed the optional property `data/category/goal_cadence` from the response with the `201` status
  - removed the optional property `data/category/goal_cadence_frequency` from the response with the `201` status
  - removed the optional property `data/category/goal_creation_month` from the response with the `201` status
  - removed the optional property `data/category/goal_day` from the response with the `201` status
  - removed the optional property `data/category/goal_months_to_budget` from the response with the `201` status
  - removed the optional property `data/category/goal_needs_whole_amount` from the response with the `201` status
  - removed the optional property `data/category/goal_overall_funded` from the response with the `201` status
  - removed the optional property `data/category/goal_overall_left` from the response with the `201` status
  - removed the optional property `data/category/goal_percentage_complete` from the response with the `201` status
  - removed the optional property `data/category/goal_snoozed_at` from the response with the `201` status
  - removed the optional property `data/category/goal_target` from the response with the `201` status
  - removed the optional property `data/category/goal_target_date` from the response with the `201` status
  - removed the optional property `data/category/goal_target_month` from the response with the `201` status
  - removed the optional property `data/category/goal_type` from the response with the `201` status
  - removed the optional property `data/category/goal_under_funded` from the response with the `201` status
  - removed the optional property `data/category/note` from the response with the `201` status
  - removed the optional property `data/category/original_category_group_id` from the response with the `201` status
  - added the new optional request property `category/allOf[#/components/schemas/SaveCategory]/goal_needs_whole_amount`
  - added `#/components/schemas/CategoryBase, subschema #2` to the `data/category` response property `allOf` list for the response status `201`
- **2026-04-01** `60411c83c141`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ynab/apis/ynab-api-endpoints/docs/plans/:plan_id/categories/post.md) - [API](https://skmtc.dev/ynab/apis/ynab-api-endpoints.md) - [Page](https://skmtc.dev/ynab/apis/ynab-api-endpoints/changes/plans/:plan_id/categories/post)