---
title: "Create category"
method: POST
path: "/resources/permissions/v1/categories"
tags: ["Permission categories"]
---

# Create category

`POST /resources/permissions/v1/categories`

## Request

- Base URL: `http://localhost:8181`
- URL: `http://localhost:8181/resources/permissions/v1/categories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/docs/resources/permissions/v1/categories/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this route to add a new permissions category. Each category you add requires you to send information about the category in the POST body. Note that you do not associate the category with permissions here. You do that using the add and update permission routes where you send the category ID as a body parameter.

## Request body

- CreateCategoryDto
  - `name` string, required
  - `description` string

## Response `201`

- PermissionCategoryResponseDto
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `createdAt` string, date-time, required
  - `feCategory` boolean, required

---

[API](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp.md) - [All operations](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/llms.txt) - [OpenAPI document](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/revisions/c496ae9e1c3e?raw)