---
title: "Bulk create groups"
method: POST
path: "/scim/v2/Groups/bulk"
tags: ["SCIM"]
---

# Bulk create groups

`POST /scim/v2/Groups/bulk`

Creates multiple Groups within an organization.

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.

## Request body

- object[] — Array of group resources returned by the bulk operation.
  - `schemas` string[], required — List of schema URNs defining the structure of the group resource.
  - `displayName` string, required — Name of the group.
  - `urn:zuora:scim:schemas:1.0:GroupExtension` object, required — Custom extension schema with additional attributes for the group.
    - `schemas` string[] — List of URNs for the extension schemas.
    - `description` string — Description of the group.
    - `organizationId` string — Identifier for the associated organization.
    - `active` boolean — Indicates whether the group is active.
  - `meta` object, nullable, required — Metadata about the group resource.
    - `resourceType` string — Type of the resource (e.g., Group).

## Response `200`

OK

- object
  - `schemas` string[] — List of schema URNs defining the structure of the response.
  - `totalResults` integer — Total number of user groups returned in the response.
  - `id` string, nullable
  - `externalId` string, nullable
  - `meta` string, nullable
  - `resources` object[] — List of group resources returned by the query.
    - `schemas` string[] — List of schema identifiers that define the format of the group resource.
    - `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 attributes for the group.
      - `schemas` string[] — List of URNs for the extension schemas.
      - `description` string — Description of the group.
      - `organizationId` string — Identifier for the associated organization.
      - `active` boolean — Indicates whether the group is active.
    - `meta` object, nullable — Metadata about the group resource.
      - `resourceType` string — Type of the resource (e.g., Group).
      - `location` string — URL to access the group resource.
  - `startIndex` integer
  - `itemsPerPage` integer

## Other responses

- `201` — Created
- `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)