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

# Create a category

`POST /categories`

## Request

- Base URL: `https://api.fanheroapi.com`
- URL: `https://api.fanheroapi.com/categories`
- Auth: API key in header `apiKey`

## Headers

- `channel` string, required
- `organization` string, required

## Request body

- CreateCategoryInput
  - `name` string, required: Category name
  - `entitlements` string[], required: Entitlemetns. A string array of product IDs.
  - `password` string: Password
  - `kind` string, required: Access level of this category
  - `slug` string: Category slug
  - `posts` string[]: Array of post IDs

## Response `201`

Category created.

---

[API](https://skmtc.dev/fanhero/apis/headless-cms-endpoints.md) - [All operations](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/revisions/fb8d50c05ee6?raw)
