# Create group

Create a group for your users. Required permissions: apps:create, [appId]:create, groups:create.

Endpoint: POST /v1/groups
Security: ClientAccessToken

## Request fields (application/json):

  - `name` (string, required)
    Name of the group to create

  - `description` (string)

  - `custom_data` (object)
    Group custom data object

## Response 201 fields (application/json):

  - `result` (object, required)

  - `result.group_id` (string, required)
    Group ID

  - `result.name` (string, required)
    Group name

  - `result.description` (string)
    Group description

  - `result.created_at` (number, required)
    Date group was created in the tenant

  - `result.updated_at` (number, required)
    Date group was last updated

  - `result.custom_data` (object)
    Group custom data object

## Response 409 fields (application/json):

  - `message` (string, required)

  - `error_code` (number, required)

  - `ts_error_code` (string, required)