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

# Create category

`POST /category`

Creates a new category, if property key in model is not defined, the key will be the same as categoryId

## Request body

- CategoryApiModel — A category
  - `CategoryId` integer — The id of the category. Uniquely identifies a category
  - `Key` string — The key of the category. If feature 'Use alphanumeric category IDs' is enabled, this will be used as identifier instead of id.
  - `Name` string — The name of the category
  - `Rank` integer — The rank of the category
  - `Status` 'Active' | 'InActive' — The status of the category
  - `LandingPage` CategoryLandingPageApiModel — Landing page of a category with settings for templates etc.
    - `FilterTemplateId` integer — The id of connected filter template (null -> use parent template)
    - `MerchandisingTemplateId` integer — The id of connected merchandising template (null -> use parent template)
    - `MerchandisingBuilderId` integer — The id of connected merchandising builder (-1 -> use parent builder)
  - `Parents` integer[] — The parents of the category
  - `Url` string — The category url

## Response `200`

The id of the created category

- integer

## Other responses

- `400` — BadRequest

---

[API](https://skmtc.net/tweakwise/apis/frontend-api.md) · [All operations](https://skmtc.net/tweakwise/apis/frontend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tweakwise/frontend-api/revisions/9bd1e2b3633f/schema)