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

# Create product category

`POST /product-categories`

Creates a new product category

**Scopes:**
`products.write`
<br><a href="https://www.postman.com/omnisend-api/workspace/omnisend/overview" target="_blank">Check POSTMAN documentation</a>

## Headers

- `Omnisend-Version` string, required

## Request body

- CreateCategoryRequest — Payload for creating a product category
  - `categoryID` string, required — Product category unique identifier. Range: 1-100 characters
  - `title` string, required — Product category name. Max 255 characters

## Response `201`

Product category created successfully with the given ID

- CreateCategoryResponse — Response returned after successfully creating a product category
  - `categoryID` string — Product category unique identifier

## Other responses

- `400` — Request contains invalid or missing fields
- `401` — Authentication is missing or invalid
- `403` — Insufficient permissions for this operation
- `409` — Category already exists
- `410` — API version has been retired
- `429` — Rate limit exceeded
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/omnisend/apis/events-api.md) · [All operations](https://skmtc.net/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omnisend/events-api/versions/50214fbc283f/schema)
