# Create a new user

**POST /Users**

Creates a new user with the provided SCIM attributes.

## ✅ Supported SCIM User Properties in Adra

These properties are the only ones recognized by Adra; others are ignored at runtime.

### 🔹 SCIM Core Schema (`urn:ietf:params:scim:schemas:core:2.0:User`)

| SCIM Field          | Type    | Description                                            | Internal Mapping | Required |
|---------------------|---------|--------------------------------------------------------|------------------|----------|
| `userName`          | string  | Unique login identifier                                | `Username`       | ✅       |
| `name.givenName`    | string  | User's first name                                      | `FirstName`      | ✅       |
| `name.familyName`   | string  | User's last name                                       | `LastName`       | ✅       |
| `emails`            | array   | Must be of type `work`, `primary: true`. Only one accepted. | `Email`    | ✅       |
| `active`            | boolean | User's activation status                               | `Active`         | ❌       |
| `title`             | string  | User's job title                                       | `Title`          | ❌       |
| `timezone`          | string  | Olson format (e.g., `Europe/London`)                   | `TimeZone`       | ❌       |
| `locale`            | string  | Language/region setting (e.g., `en-GB`)                | `Culture`        | ❌       |
| `preferredLanguage` | string  | User's preferred language                              | `Language`       | ❌       |
| `externalId`        | string  | External unique ID from IdP                            | `ExternalId`     | ❌       |
| `id`                | string  | Adra-generated unique user ID                          | `OperatorGuid`   | ❌       |

### 🔹 Enterprise User Schema (`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`)

| SCIM Field         | Type    | Description                  | Internal Mapping  | Required |
|--------------------|---------|------------------------------|-------------------|---------|
| `employeeNumber`   | string  | Employee reference number    | `EmployeeNumber`  | ❌       |

> 📌 *Fields not listed above are explicitly ignored by the Adra SCIM client.*


## Servers
- Production server: https://setup.adra.com/api/organizations/{organizationSid}/scim (Production server)


## Authentication methods
- Adra personal access token


## Parameters



### Body: application/json (object)

- **enterpriseExtension** (object | null)

- **active** (boolean)

- **electronicMailAddresses** (array[object])

- **locale** (string | null)

- **meta** (object | null)

- **name** (object)

- **preferredLanguage** (string | null)

- **timeZone** (string | null)

- **title** (string | null)

- **userName** (string)

- **externalId** (string | null)

- **schemas** (array[string] | null)



## Responses
### 200
OK

#### Body: application/scim+json (object)
- **enterpriseExtension** (object | null)

- **active** (boolean)

- **electronicMailAddresses** (array[object])

- **locale** (string | null)

- **meta** (object | null)

- **name** (object)

- **preferredLanguage** (string | null)

- **timeZone** (string | null)

- **title** (string | null)

- **userName** (string)

- **externalId** (string | null)

- **schemas** (array[string] | null)


### 201
User created successfully

#### Body: application/scim+json (object)
- **enterpriseExtension** (object | null)

- **active** (boolean)

- **electronicMailAddresses** (array[object])

- **locale** (string | null)

- **meta** (object | null)

- **name** (object)

- **preferredLanguage** (string | null)

- **timeZone** (string | null)

- **title** (string | null)

- **userName** (string)

- **externalId** (string | null)

- **schemas** (array[string] | null)


### 400
Bad Request

#### Body: application/scim+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 401
Unauthorized

#### Body: application/scim+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 403
Forbidden

#### Body: application/scim+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 409
Resource already exists

### 500
Internal Server Error

#### Body: application/scim+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 501
Not Implemented

#### Body: application/scim+json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)



[Powered by Bump.sh](https://bump.sh)