# Create a user group

Creates a new user group with an optional parent group for hierarchical organization.

Request:
name              - Display name of the user group.
description       - Description of the group's purpose or membership criteria.
parentGroupId   - Optional ID of an existing group to nest this group under.

Response:
userGroup        - The created UserGroupItem containing the assigned id, name,
description, and parentGroupId.

Endpoint: POST /api/v1/user-group/create-user-group
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `name` (string)
    Rule data fields

  - `parentGroupId` (string)
    Rule data fields

  - `description` (string)
    Rule data fields

## Response 200 fields (application/json):

  - `userGroup` (object)

  - `userGroup.id` (string)
    Rule data fields

  - `userGroup.parentGroupId` (string)
    Rule data fields

  - `userGroup.name` (string)
    Rule data fields

  - `userGroup.description` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)