---
title: "Create/Update/Replace/Delete SCIM Resources (Users/ Groups) in Bulk"
method: POST
path: "/Bulk"
tags: ["Bulk Endpoint"]
---

# Create/Update/Replace/Delete SCIM Resources (Users/ Groups) in Bulk

`POST /Bulk`

This API is used to create/update/replace/delete SCIM resources in bulk. You need to specify different operations in the request payload corresponding to the type of bulk update: </br> </br> - **POST** operation: Adds new resources. </br> - **PUT** operation: Replaces an existing resource. </br> - **PATCH** operation: Updates attributes of an existing resource. </br> - **DELETE** operation: Removes an existing resource. </br>
- <b>Scopes required:</b> ``internal_bulk_resource_create``

 - <b>Flow type:</b> Client Credentials OAuth Flow

## Response `201`

Valid user is created

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `409` — Users already exists

## Changes

- **2026-07-17** `7978594f207e` — 2 breaking, 4 warning
  - the `oneOf[subschema #5: create group]/Operations/items/bulkId` request property type/format changed from `integer`/`` to `string`/``
  - the `Operations` response's property type/format changed from `object`/`` to `array`/`` for status `201`
  - removed the optional property `Operations/bulkId` from the response with the `201` status
  - removed the optional property `Operations/location` from the response with the `201` status
  - …2 more
- **2025-08-05** `d290ee2c70fc` — 2 breaking, 4 info
  - the `oneOf[subschema #5: create group]/Operations/items/bulkId` request property type/format changed from `string`/`` to `integer`/``
  - the `Operations` response's property type/format changed from `array`/`` to `object`/`` for status `201`
  - added the optional property `Operations/bulkId` to the response with the `201` status
  - added the optional property `Operations/location` to the response with the `201` status
  - …2 more

[Change history](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/changes/Bulk/post.md)

---

[API](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api.md) · [All operations](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ballerina-platform/scim-2-0-api/revisions/7978594f207e/schema)