---
title: "Create a group"
method: POST
path: "/scim/v2/Groups"
tags: ["Group API"]
---

# Create a group

`POST /scim/v2/Groups`

This creates a group inside the team, if it does not exist already. User memberships can already be specified upon creation. Group creation may fail due to license constraints. User cannot be a member of more than 50 groups.

## Query parameters

- `attributes` string
- `excludedAttributes` string

## Request body

- object

## Response `200`

OK

## Other responses

- `204` — OK, but no content to return.
- `400` — Bad Request. Please check the response contents for an explanation of the cause. Causes include exceeding the team license, non-existing group members or exceeding the maximum of 50 groups per User.
- `401` — Unauthorized. Please check whether your API key or application key has sufficient permissions. In case you are unsure, please refer the documentation on [application keys](https://help.celonis.cloud/help/display/CIBC/Application+Keys) and [permissions](https://help.celonis.cloud/help/display/CIBC/Permissions).
- `403` — Forbidden
- `500` — An internal error happened. Please forward the associated error ID along with any helpful information to [our support](https://help.celonis.cloud/help/display/CIBC/Support)

---

[API](https://skmtc.dev/celonis/apis/celonis-scim-api.md) · [All operations](https://skmtc.dev/celonis/apis/celonis-scim-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/celonis/celonis-scim-api/revisions/979f1f5a7080/schema)