Use the SCIM API to import users into PingOne. The PingOne SCIM API acts as a translation layer that receives SCIM requests to then issue as equivalent PingOne API requests, and translates PingOne API responses to SCIM-compliant responses for the user.
PingOne supports only version 2.0 of the SCIM standard.
Accessing the PingOne SCIM API
The URI for the PingOne SCIM API is
https://scim-api.pingone.com/environments/{{envID}}/v2/
where {{envID}} is the ID for the appropriate PingOne environment.
Using the /Users endpoint
Use the /Users endpoint to create, update, and delete users.
The URI for the /Users endpoint is
{{scimPath}}/environments/{{envID}}/v2/Users
- {{scimPath}} is the regional domain for the PingOne SCIM service provider, such as https://scim-api.pingone.com or https://scim-api.pingone.eu.
- {{envID}} is the ID for the appropriate PingOne environment.
Examples
- Create user
- POST {{scimPath}}/environments/{{envID}}/v2/Users
- Read one SCIM user
- GET {{scimPath}}/environments/{{envID}}/v2/Users/{{userID}}
- Read all SCIM users
- GET {{scimPath}}/environments/{{envID}}/v2/Users
- Delete SCIM user
- DELETE {{scimPath}}/environments/{{envID}}/v2/Users/{{userID}}
You can use the /DirectMappedUsers endpoint to pass attributes
exactly as they appear in the PingOne schema. You can pass any attributes, including custom
attributes, by including the exact name of the attribute in the SCIM payload.
For more information, see SCIM in the PingOne API Reference.