---
title: "Create Category"
method: POST
path: "/{client_id}/categories/"
---

# Create Category

`POST /{client_id}/categories/`

## Request

- Base URL: `https://cf-blast.livelikecdn.com/api/v1/applications`
- URL: `https://cf-blast.livelikecdn.com/api/v1/applications/{client_id}/categories/`
- Auth: API key in header `Authorization`

Creates a category inside a reward store. It is always created in the `draft` state, so it is not visible to members until you publish it. Requires a producer access token for the application.

The store must be an active store in this application, and it can't be changed later. The name must be unique among the store's active categories. If you leave out `sequence`, the category goes to the next free position. A category needs a `sequence` and a `description` before it can be published.

## Path parameters

- `client_id` string, required

## Request body

- object
  - `product_store_id` string, uuid, required: The reward store this category belongs to. It must be an active store in this application and can't be changed later.
  - `name` string, required: Name of the category. Max 255 characters, and unique among the store's active categories.
  - `description` string: Description of the category. Required before the category can be published.
  - `sequence` integer, nullable: Position of the category in the store, zero or higher. If omitted, it goes to the next free position. Must be unique among the store's active categories.
  - `custom_data` string: Free text, for example serialized JSON.
  - `attributes` object[]: Key and value pairs. Both key and value are required. An identical pair twice is rejected.
    - `key` string
    - `value` string

## Response `201`

Created. The category is returned in the draft state.

- object
  - `id` string, uuid
  - `name` string
  - `sequence` integer, nullable
  - `state` string
  - `is_active` boolean

## Other responses

- `400`: Validation error.

---

[API](https://skmtc.dev/livelike/apis/applications.md) - [All operations](https://skmtc.dev/livelike/apis/applications/llms.txt) - [OpenAPI document](https://skmtc.dev/livelike/apis/applications/revisions/841be2451373?raw)