# Bulk create groups

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.

Endpoint: POST /scim/v2/Groups/bulk
Version: 2026-02-20
Security: bearerAuth

## Request fields (application/json):

  - `schemas` (array, 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.

  - `urn:zuora:scim:schemas:1.0:GroupExtension.schemas` (array)
    List of URNs for the extension schemas.

  - `urn:zuora:scim:schemas:1.0:GroupExtension.description` (string)
    Description of the group.

  - `urn:zuora:scim:schemas:1.0:GroupExtension.organizationId` (string)
    Identifier for the associated organization.

  - `urn:zuora:scim:schemas:1.0:GroupExtension.active` (boolean)
    Indicates whether the group is active.

  - `meta` (object,null, required)
    Metadata about the group resource.

  - `meta.resourceType` (string)
    Type of the resource (e.g., Group).

## Response 200 fields (application/json):

  - `schemas` (array)
    List of schema URNs defining the structure of the response.
    Example: ["urn:ietf:params:scim:api:messages:2.0:ListResponse"]

  - `totalResults` (integer)
    Total number of user groups returned in the response.
    Example: 2

  - `id` (string,null)

  - `externalId` (string,null)

  - `meta` (string,null)

  - `resources` (array)
    List of group resources returned by the query.

  - `resources.schemas` (array)
    List of schema identifiers that define the format of the group resource.
    Example: ["urn:ietf:params:scim:schemas:core:2.0:Group","urn:zuora:scim:schemas:1.0:GroupExtension"]

  - `resources.id` (string)
    Unique identifier for the group.
    Example: "5aa8a1fe-4ed4-44db-a6ae-78645a20ae21"

  - `resources.displayName` (string)
    Name of the group.
    Example: "test_group_1"

  - `resources.urn:zuora:scim:schemas:1.0:GroupExtension` (object)
    Custom extension schema with additional attributes for the group.

  - `resources.urn:zuora:scim:schemas:1.0:GroupExtension.schemas` (array)
    List of URNs for the extension schemas.
    Example: ["urn:zuora:scim:schemas:1.0:GroupExtension"]

  - `resources.urn:zuora:scim:schemas:1.0:GroupExtension.description` (string)
    Description of the group.

  - `resources.urn:zuora:scim:schemas:1.0:GroupExtension.organizationId` (string)
    Identifier for the associated organization.
    Example: "ec141dc2-901e-4813-a25d-ef480cff1e26"

  - `resources.urn:zuora:scim:schemas:1.0:GroupExtension.active` (boolean)
    Indicates whether the group is active.
    Example: true

  - `resources.meta` (object,null)
    Metadata about the group resource.

  - `resources.meta.resourceType` (string)
    Type of the resource (e.g., Group).
    Example: "Group"

  - `resources.meta.location` (string)
    URL to access the group resource.
    Example: "http://localhost:9900/scim/v2/Groups/bulk/5aa8a1fe-4ed4-44db-a6ae-78645a20ae21"

  - `startIndex` (integer)

  - `itemsPerPage` (integer)

## Response 401 fields (application/json):

  - `success` (boolean)
    Indicates whether the request was successful (false for errors).

  - `reasons` (array)
    List of reasons for the unauthorized error.

  - `reasons.message` (string)
    Error message indicating the reason for unauthorized access.
    Example: "Unauthorized"

  - `reasons.code` (string)
    Error code associated with the unauthorized error.
    Example: "90000011"

## Response 403 fields (application/json):

  - `timestamp` (string)
    Time when the error occurred.
    Example: "2023-07-28T10:47:07.931+00:00"

  - `status` (integer)
    HTTP status code indicating the forbidden error.
    Example: 403

  - `error` (string)
    Type of error indicating a forbidden action.
    Example: "Forbidden"

  - `message` (string)
    Description of why the action is forbidden.
    Example: "Admin access denied"

  - `path` (string)
    Endpoint path where the error occurred.
    Example: "/scim/v2/Groups/bulk"

## Response 404 fields (application/json):

  - `schemas` (array)
    List of schema URNs defining the structure of the error response.
    Example: ["urn:ietf:params:scim:api:messages:2.0:Error"]

  - `status` (string)
    HTTP status code indicating that the resource was not found.
    Example: "404"

  - `detail` (string)
    Details explaining why the resource was not found.
    Example: "Resource not found"


## Response 201 fields