# Create a new forum category

Creates a new category within a forum. Categories organize forum discussions into topics.

RBAC: requires GroupForum.Manage

Endpoint: POST /api/v1/groups/{groupId}/categories
Version: 1.0
Security: 

## Path parameters:

  - `groupId` (string, required)
    The unique identifier of the group
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Request fields (application/json):

  - `name` (string, required)

  - `displayName` (string, required)

  - `description` (string, required)

  - `meta` (object, required)
    Category additional data

  - `meta.color` (string, required)
    Category color in HEX format
    Example: "#FF5733"

  - `tagsAllowed` (array,null)

## Response 200 fields (application/json):

  - `id` (string, required)
    UUID with type prefix
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `forumId` (string, required)
    UUID with type prefix
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `name` (string, required)

  - `displayName` (string, required)

  - `description` (string, required)

  - `meta` (object, required)
    Category additional data

  - `meta.color` (string, required)
    Category color in HEX format
    Example: "#FF5733"

  - `tagsAllowed` (array, required)

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation


## Response 400 fields