Generic SCIM Endpoint - Create User
The Create User endpoint creates the requested User in strongDM.
Request
Endpoint
/provisioning/generic/v2/Users
HTTP method
POST
Request body attributes
Attribute | Description | Example |
---|---|---|
active | The User's status (Boolean). Set to false to suspend a User upon creation. | active: false |
name | The User's name, comprising givenName and familyName properties | {"givenName": "Firstname", "familyName": "Lastname"} |
schemas | The schema URI for representing users. Include the value as indicated in the example. | "urn:ietf:params:scim:schemas:core:2.0:User" |
userName | The User's username | "myUser@example.test" |
Example request
POST app.strongdm.com/provisioning/generic/v2/Users
{"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],"userName": "myUser@example.test","name": {"givenName": "Firstname","familyName": "Lastname"},"active": true}
Response
Example success response
(Status 201)
{"active": true,"displayName": "Firstname Lastname","id": "a-1377f104617182e1","meta": { "resourceType": "User", "location": "Users/a-1377f104617182e1" },"name": {"familyName": "Lastname","formatted": "Firstname Lastname","givenName": "Firstname"},"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],"userName": "myUser@example.test","userType": "user"}
Example response if there was a conflicting email
{"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],"scimType": "uniqueness","detail": "One or more of the attribute values are already in use or are reserved.","status": "409"}
Example response if there was no email
{"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],"detail": "could not create user: cannot create user: invalid operation: email cannot be blank","status": "400"}