---
title: "Changes to Create a new Category."
method: POST
path: "/categories.json"
---

# Changes to Create a new Category.

`POST /categories.json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 12 revisions.

- **2026-10-15** `53dc9f2c1329`: 2 breaking, 9 info

## Changes

- **2026-10-15** `53dc9f2c1329`: 2 breaking, 9 info
  - the request property `category/name` became required
  - the response property `category/parent_id` became nullable for the status `200`
  - the security scope `categories` was added to the endpoint's security scheme `BasicAuthentication`
  - the security scope `write_categories` was added to the endpoint's security scheme `OAuth2`
  - the security scope `assets` was removed from the endpoint's security scheme `BasicAuthentication`
  - the security scope `write_store` was removed from the endpoint's security scheme `OAuth2`
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the optional property `category/description` to the response with the `200` status
  - added the optional property `category/images` to the response with the `200` status
  - added the optional property `category/products` to the response with the `200` status

---

[Operation](https://skmtc.dev/jumpseller/apis/jumpseller-api/docs/categories.json/post.md) - [API](https://skmtc.dev/jumpseller/apis/jumpseller-api.md) - [Page](https://skmtc.dev/jumpseller/apis/jumpseller-api/changes/categories.json/post)