---
title: "Create a custom integration-level category"
method: POST
path: "/categories"
tags: ["Category Personalization"]
---

# Create a custom integration-level category

`POST /categories`

Create a custom integration-level category.

This category will be available to all users of your integration.

To learn more about category personalization, please read the [Category Personalization Guide](https://docs.spade.com/reference/category-personalization-guide).

## Request body

- CommonPostCategoriesRequest — Schema for creating a custom category.
  - `name` string, required — The name of the category (must be unique per integration / user).
  - `parentId` string, required — The ID of the new category's parent. Can be a Spade category ID (e.g. "011-000-000-000") or a custom category ID (e.g. "e4cf5379-583f-44ed-b625-366044e666e6").

## Response `201`

Successful operation

- CustomCategory
  - `id` string — A unique identifier for this category.
  - `name` string — The category's name
  - `icon` string, url, nullable — The category's icon, potentially inherited from the parent category.
  - `fullCategoryHierarchy` IndustryCategoryLevel[] — Array with increasingly specific category information.
    - `id` string
    - `name` string
    - `icon` string, url, nullable — Category icon.

## Other responses

- `400` — Invalid input
- `403` — Unauthorized
- `500` — Unexpected Error

---

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