---
title: "Changes to Create User"
method: POST
path: "/Users"
---

# Changes to Create User

`POST /Users`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-07-17** `7978594f207e` — 5 breaking
- **2025-08-05** `d290ee2c70fc` — 4 breaking, 1 info

## Changes

- **2026-07-17** `7978594f207e` — 5 breaking
  - the `oneOf[subschema #1: Set a password for the user]/schemas` request property type/format changed from `object`/`` to `array`/``
  - the `oneOf[subschema #2: Invite the user to set their own password]/schemas` request property type/format changed from `object`/`` to `array`/``
  - response property `emails/items/` list-of-types was widened by adding types `string` to media type `application/scim+json` of response `201`
  - the `roles` response's property type/format changed from `object`/`` to `array`/`` for status `201`
  - the `schemas` response's property type/format changed from `object`/`` to `array`/`` for status `201`
- **2025-08-05** `d290ee2c70fc` — 4 breaking, 1 info
  - the `oneOf[subschema #1: Set a password for the user]/schemas` request property type/format changed from `array`/`` to `object`/``
  - the `oneOf[subschema #2: Invite the user to set their own password]/schemas` request property type/format changed from `array`/`` to `object`/``
  - the `roles` response's property type/format changed from `array`/`` to `object`/`` for status `201`
  - the `schemas` response's property type/format changed from `array`/`` to `object`/`` for status `201`
  - response property `emails/items/` list-of-types was narrowed by removing types `string` from media type `application/scim+json` of response `201`

---

[Operation](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/docs/Users/post.md) · [API](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api.md) · [Page](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/changes/Users/post)