---
title: "Create User"
method: POST
path: "/Users"
tags: ["Users Endpoint"]
---

# Create User

`POST /Users`

This API creates a user and returns the user details along with the user's unique ID.

 - <b>Scope(Permission) required:</b> ``internal_user_mgt_create``

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

## Query parameters

- `attributes` string
- `excludedAttributes` string

## Response `201`

User is created.

## Other responses

- `400` — Invalid Input
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

## 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`
  - …1 more
- **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`
  - …1 more

[Change history](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/changes/Users/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)