---
title: "Create a new group"
method: POST
path: "/groups"
tags: ["groups"]
---

# Create a new group

`POST /groups`

## Request

- Base URL: `https://pmp-demo.privateplatform.mendix.com/groupservice/v1`
- URL: `https://pmp-demo.privateplatform.mendix.com/groupservice/v1/groups`
- Auth: API key in header `Authorization`

## Create a new group

Name field is mandatory. Name can only be alphanumeric, spaces, underscores, or dashes. Max length for name field is 100 characters. Max length for Description is 250 characters.

## Request body

- GroupInput: Group creation request
  - `name` string, required: Group name
  - `description` string: Group description
  - `parentGroupName` string, required: Parent group name

## Response `201`

Group

- object
  - `id` string
  - `name` string
  - `description` string
  - `memberCount` integer
  - `parentGroup` string

## Other responses

- `400`: Invalid input parameter or request body
- `401`: Authentication information is missing or invalid
- `403`: User has no permission for this operation
- `404`: Resource not found

---

[API](https://skmtc.dev/mendix/apis/group-service.md) - [All operations](https://skmtc.dev/mendix/apis/group-service/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/group-service/revisions/29f93a161f65?raw)