SCIM API for User Creation
Use the SCIM API for creating a user in the Unified Directory.
Authentication
Authorization: Bearer <Client Secret>
Use the copied Client Secret key as the Authorization key value.
Request Requirements
| Method | Request URL | Response Content Type | Response Body | Response Codes |
|---|---|---|---|---|
| POST | <Base URI>/Users | application/scim+json | User details | 201, 400, 401, 409, 500 |
Example Request Data
POST <Base URI>/Users
Authorization: Bearer 29da0602f6db1ed033aa91d644ce4d70bdf3ab58
Content-Type: application/scim+json
Example Request Body
The following examples display a user creation request.
User Creation - Minimal User Representation
{
"userName": "User One",
"emails": [{
"type": "work",
"value": "user.one@example.com"
}
]
}User Creation - Full User Representation
{
"userName": "clouduser5",
"displayName": "clouduser5-dn",
"nickName": "clouduser5-nn",
"password": "SamplePassword@123",
"title": "clouduser5-title",
"active": true,
"emails": [{
"type": "work",
"value": "clouduser5@example.com",
"primary": true
}, {
"type": "home",
"value": "clouduser5home@example.com",
"primary": false
}, {
"type": "other",
"value": "clouduser5other@example.com",
"primary": false
}
],
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"name": {
"givenName": "clouduser5-givenName",
"familyName": "clouduser5-familyName",
"formatted": "clouduser5-formatted",
},
"phoneNumbers": [{
"type": "work",
"value": "+31 65 7777777",
"primary": true
}, {
"type": "mobile",
"value": "+31 65 8888888",
"primary": false
}, {
"type": "home",
"value": "+31 65 9999999",
"primary": false
}, {
"type": "pager",
"value": "+31 65 999999",
"primary": false
}, {
"type": "fax",
"value": "+31 65 999999",
"primary": false
}, {
"type": "other",
"value": "+31 65 999999",
"primary": false
}
],
"addresses": [{
"type": "work",
"formatted": "changedformatted",
"streetAddress": "changedworkStreetAddress",
"locality": "changedlocality",
"region": "changedregion",
"postalCode": "changedpostalCode",
"country": "changedcountry",
"primary": true
}, {
"type": "home",
"formatted": "changedformatted",
"streetAddress": "changedworkStreetAddress",
"locality": "changedlocality",
"region": "changedregion",
"postalCode": "changedpostalCode",
"country": "changedcountry",
"primary": false
}, {
"type": "other",
"formatted": "formatted",
"streetAddress": "changedWorkStreetAddress",
"locality": "locality",
"region": "region",
"postalCode": "postalCode",
"country": "country",
"primary": false
}
],
"locale": "EN_US",
"preferredLanguage": "English",
"userType": "Employee",
}
Request Body Parameters
See the SCIM Attributes section for the request parameters.
Response
The API returns the user details.
Example Response
User Creation - Minimal User Representation
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"id": "400e299e-3b99-4cb7-9f17-c315290ffeb9",
"meta": {
"resourceType": "User",
"created": "2022-12-17T09:03:39-05:00",
"lastModified": "2022-12-17T09:03:39-05:00",
"location": "<Base URI>/Users/400e299e-3b99-4cb7-9f17-c315290ffeb9"
},
"userName": "User One",
"active": true,
"emails": [{
"type": "work",
"value": "user.one@example.com"
}
]
}
User Creation - User Representation
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"id": "15b2c192-052f-913c-7bcb-d84cb8101fba",
"meta": {
"resourceType": "User",
"created": "2023-01-20T06:13:46.663Z",
"lastModified": "2023-01-20T06:13:46.663Z",
"location": "<Base URI>/Users/d4dd1651-fd28-b8b3-b485-8912862b0033"
},
"userName": "clouduser5",
"name": {
"formatted": "clouduser5-formatted",
"familyName": "clouduser5-familyName",
"givenName": "clouduser5-givenName"
},
"displayName": "clouduser5-dn",
"nickName": "clouduser5-nn",
"title": "clouduser5-title",
"userType": "Employee",
"preferredLanguage": "English",
"locale": "clouduser5-locale",
"active": true,
"emails": [{
"value": "clouduser5@example.com",
"type": "work",
"primary": true
}, {
"value": "clouduser5home@example.com",
"type": "home",
"primary": false
}, {
"value": "clouduser5other@example.com",
"type": "other",
"primary": false
}
],
"phoneNumbers": [{
"value": "+31 65 7777777",
"type": "mobile",
"primary": false
}, {
"value": "+31 65 8888888",
"type": "work",
"primary": true
}, {
"value": "+31 65 9999999",
"type": "home",
"primary": false
}, {
"value": "+31 65 9999999",
"type": "fax",
"primary": false
}, {
"value": "+31 65 9999999",
"type": "pager",
"primary": false
}, {
"value": "+31 65 9999999",
"type": "other",
"primary": false
}
],
"addresses": [{
"formatted": "changedformatted",
"streetAddress": "changedworkStreetAddress",
"locality": "changedlocality",
"region": "changedregion",
"postalCode": "changedpostalCode",
"country": "changedcountry",
"type": "home",
"primary": false
}, {
"formatted": "changedformatted",
"streetAddress": "changedworkStreetAddress",
"locality": "changedlocality",
"region": "changedregion",
"postalCode": "changedpostalCode",
"country": "changedcountry",
"type": "work",
"primary": true
}, {
"formatted": "formatted",
"streetAddress": "changedWorkStreetAddress",
"locality": "locality",
"region": "region",
"postalCode": "postalCode",
"country": "country",
"type": "other",
"primary": false
}
]
}
Response Property Descriptions
See SCIM Attributes.
Response Codes
The following table shows response codes for this API.
| Code | Description |
|---|---|
| 201 | Created |
| 400 | Bad Request Error message examples:
{ Value for attribute schemas must contain schema URI urn:ietf:params:scim:schemas:core:2.0:User because it is the core schema for this resource type, Schema URI urn:ietf:params:scim:schemas:core:2.0:Userss is not a valid value for attribute schemas[0] because it is undefined as a core or schema extension for this resource type. }
{ Schema URI urn:ietf:params:scim:schemas:extension:enterpriser:2.0:User is not a valid value for attribute schemas[1] because it is undefined as a core or schema extension for this resource type. }
{ Value test is not valid for attribute emails[0].type because it is not one of the canonical types: other, work, home. }
{ Value help is not valid for attribute phoneNumbers[0].type because it is not one of the canonical types: other, pager, work, mobile, fax, home. }
{ Extended attributes namespace urn:ietf:params:scim:schemas:extension:enterprise:2.0:User must be included in the schemas attribute. } |
| 409 |
|
| 500 | Unable to set password for user. |
Related Articles
Creation of an Admin Exceptions Tabular Report fails with 'ORA-01031: insufficient privileges' error in RSA Identity Gover… Number of Views Impact of missing information on creation of Profiles by Risk Engine Number of Views RSA Governance & Lifecycle Blueprint - Bulk Application Creation Number of Views When removing a user from a large number of Roles, the Change Request creation fails with an 'ORA-01704: string literal to… Number of Views The "User Cannot change the password" flag for Active Directory Account creation in RSA Identity Governance and Lifecycle … Number of Views
Trending Articles
Quick Setup Guide - Passwordless Authentication in Windows MFA Agent for Active Directory RSA MFA Agent 2.5 for Microsoft Windows Installation and Administration Guide RSA MFA Agent 2.3.6 for Microsoft Windows Installation and Administration Guide How to Download OTP Token Seed Files from myRSA RSA Authentication Manager 8.9 Release Notes (January 2026)
