---
title: "Creates a new user group"
method: POST
path: "/gdc/internal/usergroups"
tags: ["user-groups"]
---

# Creates a new user group

`POST /gdc/internal/usergroups`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/internal/usergroups`
- Auth: none declared

This resource is an alias of `/gdc/userGroups`.

## Request body

- UserGroup
  - `userGroup` object, required
    - `content` UserGroupContent, required
      - `name` string, required
      - `id` string, nullable: Id of the user group is ignored in POST, as it is not known.
      - `description` string, nullable
      - `domain` union: Deprecated, value ignored. It is here because of backward compatibility.
        - string, uri: URI of the domain
        - string, uri, nullable: Domain uri in a deprecated format because of backward compatibility.
      - `project` string, uri, nullable: Can not be changed in PUT. Has to be specified.
    - `meta` UserGroupMeta: User group metainformation is ignored in write operations.
      - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
    - `links` UserGroupLinks
      - `self` string, required: URI of the user group
      - `members` string, uri, required
      - `modifyMembers` string, uri, required

## Response `201`

New user group was successfully created

- Uri: URI containing mandatory root key
  - `uri` string, uri, required

## Other responses

- `400`: Operation failed because of invalid combination of query parameters.
- `403`: The API call failed because you do not have persmission to modify user groups and their members ("UserGroupWritePermission").
- `default`: Common error

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)