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

# Create a portal category

`POST /portal-categories`

User must have the ENVIRONMENT_DOCUMENTATION[create] permission.

## Request body

- CreatePortalCategory — Portal category to create
  - `title` string, required — The title of the portal category
  - `description` string — The description of the portal category
  - `visible` boolean — Whether the portal category is visible on the portal

## Response `201`

Portal category created

- PortalCategory — A Portal Next category, used to group APIs on the New Developer Portal
  - `id` string, uuid, required — The unique ID of the portal category
  - `title` string, required — The title of the portal category
  - `description` string — The description of the portal category
  - `visible` boolean — Whether the portal category is visible on the portal

## Other responses

- `409` — A portal category with the same title already exists in this environment
- `default` — Generic error response

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-environments/revisions/37e8cbe5f769/schema)