---
title: "Create a group category"
method: PUT
path: "/groups/categories"
tags: ["Groups"]
---

# Create a group category

`PUT /groups/categories`

Create a new group category

## Request body

- GroupCategory
  - `parent` string, uuid, required — The parent category of the groups
  - `id` string, uuid — Group category id, only provide it when needed.
  - `name` string, required — Name of the group category
  - `description` string — Group category description

## Response `200`

Groups category information

- object
  - `result` 'success' | 'error', required — Result of the request
  - `action` 'CreateGroupCategory', required — The id of the action
  - `data` object, required
    - `groupCategories` GroupCategory[], required
      - `parent` string, uuid, required — The parent category of the groups
      - `id` string, uuid — Group category id, only provide it when needed.
      - `name` string, required — Name of the group category
      - `description` string — Group category description

---

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