Percipio
Connect Percipio to Ploy to see every user in your Percipio organization, their Percipio role, and whether their account is active. Ploy only reads from Percipio: it does not add, change or remove users.
This integration is in beta
The Percipio integration is in beta. It was built from Percipio's API documentation and has not yet been checked against a live Percipio organization, so some details may need adjusting once customers connect it. Beta does not limit what the integration can do.
The first step of setup is a consent checkbox. Ticking it lets Ploy capture redacted error data when a request to Percipio fails: the error response Percipio sends back, with personal details, tokens and other secrets removed. Ploy uses it only to fix problems with this integration. You must tick the box to continue.
What Ploy reads
Every user in your Percipio organization, with their name, email address and login name
Each user's Percipio role
Whether each user's Percipio account is active
Ploy does not read your content catalog, learning activity, assignments, approval managers or custom user attributes.
Before you start
You need two things from Percipio:
Your Percipio organization ID. It is the ID that appears in every Percipio API address, after
/organizations/.An API bearer token for that organization that is allowed to use the User Management API.
Skillsoft issues Percipio API access. If you do not already have a token and your organization ID, ask your Percipio administrator or your Skillsoft account team for API access to the User Management API. Treat the token like a password.
Connect Percipio in Ploy
In Ploy, open Integrations and choose Percipio.
Tick the beta consent checkbox.
Paste your Percipio organization ID.
Paste the bearer token.
Click Test. Ploy reads one user from your Percipio organization to check the token and organization ID work.
Finish the setup. The first scan starts straight away.
Things to know
Users are checked every hour.
A user whose Percipio account is inactive loses their access in Ploy at the next scan.
A user deleted from Percipio loses their access in Ploy once a later scan confirms they are gone.
Percipio's API cannot add, deactivate or remove users, or change roles. Users arrive in Percipio through your HR or learning system connector or through single sign-on, so make those changes there.
Troubleshooting
Percipio refused the token
Check the token was copied in full and has not been revoked or replaced.
Percipio refused to list users
Check the organization ID, and that the token is allowed to use the User Management API for that organization.
Percipio did not recognise the organization ID
Copy the organization ID again from your Percipio API details. It contains only letters, digits and dashes.