Create SCIM User

POST {{scimPath}}/environments/{{envID}}/v2/Users

The POST {{scimPath}}/environments/{{envID}}/v2/Users operation creates a SCIM user in the specified environment.

Prerequisites

See the SCIM user data model for full property descriptions.

PropertyTypeRequired
addresses.countryStringOptional
addresses.formattedStringOptional
addresses.localityStringOptional
addresses.postalCodeStringOptional
addresses.regionStringOptional
addresses.streetAddressStringOptional
addressesObjectOptional
emailsStringOptional
externalIdStringOptional
localeStringOptional
name.familyNameStringOptional
name.formattedStringOptional
name.givenNameStringOptional
name.honorificPrefixStringOptional
name.honorificSuffixStringOptional
name.middleNameStringOptional
nameObjectOptional
nickNameStringOptional
passwordStringRequired
phoneNumbersStringOptional
photosObjectOptional
preferredLanguageStringOptional
timezoneDateTimeOptional
titleStringOptional
urn:pingidentity:
schemas:extension:2.0:
PingOneUser.population.id
StringOptional
userNameStringRequired

Request Body

{"userName"=>"tmp-IsabellaI-12", "name"=>{"formatted"=>"Isabella", "familyName"=>"Castile", "givenName"=>"Isabella", "middleName"=>"of", "honorificPrefix"=>"Ms."}, "nickName"=>"Isa", "title"=>"Principal Engineer", "preferredLanguage"=>"en", "emails"=>[{"value"=>"IsabellaOfCastile@example.com", "primary"=>true}], "phoneNumbers"=>[{"value"=>"+1.215-987-6543", "type"=>"primary", "primary"=>true}], "addresses"=>[{"streetAddress"=>"8 Mile Rd.", "locality"=>"Detroit", "region"=>"MI", "postalCode"=>"48203", "country"=>"US", "primary"=>true}], "urn:pingidentity:schemas:extension:2.0:PingOneUser"=>{"population"=>{"id"=>"{{popID}}"}}}

RESPONSES

status: Created

{"schemas":["urn:ietf:params:scim:schemas:core:2.0:User","urn:pingidentity:schemas:extension:2.0:PingOneUser"],"id":"14c9726d-861b-45c0-b464-92f546003d26","meta":{"resourceType":"User","created":"2023-03-07T19:24:28.621Z","lastModified":"2023-03-07T19:24:28.621Z","location":"https://scim-api.pingone.com/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/v2/Users/14c9726d-861b-45c0-b464-92f546003d26"},"userName":"tmp-IsabellaI-12","name":{"formatted":"Isabella","familyName":"Castile","givenName":"Isabella","middleName":"of","honorificPrefix":"Ms."},"nickName":"Isa","title":"Principal Engineer","preferredLanguage":"en","active":true,"emails":[{"value":"IsabellaOfCastile@example.com","primary":true}],"phoneNumbers":[{"value":"+1.215-987-6543","type":"primary","primary":true}],"addresses":[{"streetAddress":"8 Mile Rd.","locality":"Detroit","region":"MI","postalCode":"48203","country":"US","primary":true}],"urn:pingidentity:schemas:extension:2.0:PingOneUser":{"population":{"id":"cb3ef0a0-0ff5-4f60-ae82-4ae65d9d0e3a"}}}