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

# Create a group

`POST /scim/v2/Groups`

Creates a new group. Must include the displayName attribute. Users can be added to the group during creation by supplying the user ID values in the members array attribute.

## Query parameters

- `count` integer
- `filter` string
- `startIndex` integer

## Headers

- `Content-Type` string, required

## Request body

- object
  - `schemas` string[] — List of schema URNs defining the structure of the group resource.
  - `displayName` string — Name of the group.
  - `urn:zuora:scim:schemas:1.0:GroupExtension` object
    - `schemas` string[] — List of URNs for the extension schemas.
    - `description` string — Description of the group.
    - `organizationId` string — Identifier for the associated organization.

## Response `201`

Created

- object
  - `schemas` string[]
  - `id` string — Unique identifier for the group.
  - `displayName` string — Name of the group.
  - `urn:zuora:scim:schemas:1.0:GroupExtension` object — Custom extension schema with additional group attributes.
    - `schemas` string[] — List of schema identifiers that define the format of the group resource.
    - `description` string — Description of the group.
    - `organizationId` string — Identifier for the associated organization.
    - `active` boolean — Indicates if the group is active.
  - `meta` object — Metadata about the resource.
    - `resourceType` string — Type of the resource.
    - `location` string — URL of the group resource.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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