Close
logodocs

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

AttributeDescriptionExample
activeThe User's status (Boolean). Set to false to suspend a User upon creation.active: false
nameThe User's name, comprising givenName and familyName properties{"givenName": "Firstname", "familyName": "Lastname"}
schemasThe schema URI for representing users. Include the value as indicated in the example."urn:ietf:params:scim:schemas:core:2.0:User"
userNameThe 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"
}
Previous
SCIM Users
Next
Generic SCIM Endpoint - Delete User