---
title: "Add a user"
method: POST
path: "/scim/v2/Users"
tags: ["User API"]
---

# Add a user

`POST /scim/v2/Users`

This adds users to a team. It can fail if the license is exceeded. A user gets the <tt>MEMBER</tt> role by default.

## Query parameters

- `attributes` string
- `excludedAttributes` string

## Request body

- object

## Response `200`

OK

## Other responses

- `204` — OK, but no content to return.
- `400` — Bad Request. Please check the response contents for an explanation of the cause. Causes include exceeding the team license, duplicate or empty user names or names that exceed 100 characters.
- `401` — Unauthorized. Please check whether your API key or application key has sufficient permissions. In case you are unsure, please refer the documentation on [application keys](https://help.celonis.cloud/help/display/CIBC/Application+Keys) and [permissions](https://help.celonis.cloud/help/display/CIBC/Permissions).
- `403` — Forbidden
- `500` — An internal error happened. Please forward the associated error ID along with any helpful information to [our support](https://help.celonis.cloud/help/display/CIBC/Support)

---

[API](https://skmtc.dev/celonis/apis/celonis-scim-api.md) · [All operations](https://skmtc.dev/celonis/apis/celonis-scim-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/celonis/celonis-scim-api/revisions/979f1f5a7080/schema)