Create a new SCIM user

post/scim/v2/Users

Creates a new SCIM user. The userName of the SCIM user must be set by the client within the request body.

Request Samples

1

Response Samples

1{
2  "id": "fb8661b8-4125-437a-9d7e-edf3a1081321",
3  "userName": "scim-example3@sas.com",
4  "title": "Test title",
5  "active": true,
6  "externalId": "scim-example3@sas.com",
7  "displayName": "scim example 3",
8  "emails": [
9    {
10      "value": "testuser3@sas.com",
11      "type": "work"
12    }
13  ],
14  "schemas": [
15    "urn:ietf:params:scim:schemas:core:2.0:User"
16  ],
17  "meta": {
18    "resourceType": "User",
19    "created": "2025-10-16T14:41:13.219Z",
20    "lastModified": "2025-10-16T14:41:13.219Z"
21  }
22}

Request Body

SCIM 2.0 User resource for POST and PUT requests (user creation and updates). Note that id is server-generated and should not be included in requests.

NameTypeRequiredDescription
schemas
array [string]
true

SCIM schemas URN array.

id
string
false

Unique identifier for the user resource (SCIM ID).

<= 100 characters
userName
string
true

Unique identifier for the user, typically used by the user to directly authenticate. REQUIRED.

<= 100 characters
Match pattern:
^(?!.*<[Ss][Cc][Rr][Ii][Pp][Tt][\s\S]*?>).*$
externalId
string
false

An identifier for the resource as defined by the provisioning client.

displayName
string
false

The name of the user, suitable for display to end users.

<= 100 characters
Match pattern:
^(?!.*<[Ss][Cc][Rr][Ii][Pp][Tt][\s\S]*?>).*$
title
string
false

The User's title, such as "Vice President".

<= 100 characters
active
boolean
false

A Boolean value indicating the User's administrative status.

emails
array [scimEmailAddress]
false

Email addresses for the user.

phoneNumbers
array [scimPhoneNumber]
false

Phone numbers for the user.

addresses
array [scimAddress]
false

Physical mailing addresses for the user.

meta
object
false

Resource metadata.

undefined
false

Responses

StatusMeaningDescription
201Created

A new user was created.

HeadersSchema
400Bad Request

The request was invalid.

401Unauthorized

Authentication is required.

403Forbidden

The authenticated user does not have sufficient privileges.

Schema
409Conflict

Conflict. The user could not be created since a user with the same ID already exists