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

# Bulk delete groups

`POST /scim/v2/Groups/delete`

Permanently removes groups from an organization (members are not deleted, only the group).

## Headers

- `Idempotency-Key` string — Specify a unique idempotency key to ensure that a POST or PATCH request is idempotent. Do not use this header for other request types.
- `Accept-Encoding` string — Include the `Accept-Encoding: gzip` header to compress responses as a gzipped file. It can significantly reduce the bandwidth required for a response. If specified, Zuora automatically compresses responses that contain over 1000 bytes of data, and the response contains a `Content-Encoding` header with the compression algorithm so that your client can decompress it.
- `Content-Encoding` string — This header is returned if you specify the `Accept-Encoding: gzip` request header and the response contains over 1000 bytes of data. Note that only the following MIME types support gzipped responses: - `application/json` - `application/xml` - `text/html` - `text/csv` - `text/plain`
- `Authorization` string — The value is in the `Bearer {token}` format where {token} is a valid OAuth token generated by calling [Create an OAuth token](https://developer.zuora.com/api-references/api/operation/createToken).
- `Zuora-Track-Id` string — A custom identifier for tracing the API call. If you set a value for this header, Zuora returns the same value in the response headers. This header enables you to associate your system process identifiers with Zuora API calls, to assist with troubleshooting in the event of an issue. The value of this field must use the US-ASCII character set and must not include any of the following characters: colon (`:`), semicolon (`;`), double quote (`"`), and quote (`'`).
- `Zuora-Entity-Ids-Single` string

## Request body

- object
  - `schemas` string[], required
  - `operations` object[], required
    - `op` 'add' | 'remove' | 'replace'
    - `path` string
    - `value` object[]
      - `value` string

## Response `200`

OK

- object
  - `schemas` string[] — List of schema identifiers that define the structure of the response.
  - `id` string, nullable
  - `externalId` string, nullable — An external identifier for the resource, often used for integration with external systems.
  - `meta` object, nullable — Metadata about the group resource.
    - `resourceType` string — Type of resource, which is 'Group' for this object.
    - `location` string
  - `totalResults` integer — Total number of groups returned in the response.
  - `resources` object[] — List of group resources included in the response.
    - `schemas` string[] — List of schema identifiers that define the format of the group resource.
    - `id` string — Unique identifier for the group.
    - `externalId` string, nullable — An external identifier for the resource, often used for integration with external systems.
    - `displayName` string — Name of the group.
    - `urn:zuora:scim:schemas:1.0:GroupExtension` object — Custom attributes for the group defined by the extension schema.
      - `description` string — Additional description for the group.
      - `organizationId` string — Identifier for the organization associated with the group.
      - `active` boolean — Indicates whether the group is active.
    - `meta` object — Metadata about the group resource.
      - `resourceType` string — Type of resource, which is 'Group' for this object.
      - `location` string
  - `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)