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

# Create Group

`POST /scim/v2/Groups`

Create a group according to SCIM v2 protocol

## Query parameters

- `feature` string, nullable

## Request body

- SCIMGroup
  - `displayName` string, required
  - `externalId` string, nullable
  - `id` string, nullable
  - `members` SCIMMember[], nullable
    - `display` string, nullable
    - `type` string, nullable
    - `value` string, required
  - `meta` object, nullable
  - `schemas` string[], required

## Response `201`

Successful Response

- SCIMGroup
  - `displayName` string, required
  - `externalId` string, nullable
  - `id` string, nullable
  - `members` SCIMMember[], nullable
    - `display` string, nullable
    - `type` string, nullable
    - `value` string, required
  - `meta` object, nullable
  - `schemas` string[], required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `scim` added
  - api tag `✨ SCIM v2 (Enterprise Only)` removed
- **2026-09-18** `082b5fabd909` — 6 info
  - api tag `✨ SCIM v2 (Enterprise Only)` added
  - api tag `scim` removed
  - added the new optional request property `members/anyOf[subschema #1]/items/type`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - …2 more
- **2026-09-11** `f9848f60f12d` — 2 info
  - api tag `scim` added
  - api tag `✨ SCIM v2 (Enterprise Only)` removed
- **2026-09-04** `b260997c7450` — 2 info
  - api tag `✨ SCIM v2 (Enterprise Only)` added
  - api tag `scim` removed
- **2026-08-27** `4a06c3148b6c` — 2 info
  - api tag `scim` added
  - api tag `✨ SCIM v2 (Enterprise Only)` removed

[Full history](https://skmtc.dev/flock/apis/litellm-api/changes/scim/v2/Groups/post.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/7ed45f30a5f0?raw)