Generic SCIM Endpoint - Create User

Last modified on August 10, 2022

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"
}
Top