UKG Pro Recruiting Integration with Testlify
Integration Steps
1. Setting up the API Integration (One Time):
- Navigate to Testlify Setting and click on Integrations
- Scroll down and select UKG Pro Recruiting
- Follow the on-screen steps to set up your account. (Refer to FAQs for more help)
- Once the setup is complete, you will see UKG Pro Recruiting Listed under the integrations page.
- Assessment Creation:
- You can create assessments on Testlify’s platform for recruitment or internal certifications.
- Assessment Linking:
- In Testlify, Admins link their existing Job Requisition from UKG Pro along with setting up invitation stage (the stage at which Assessment is to be sent to candidates) and Completion Stage (the stage at which candidate is moved to once he has completed the assessment)
- Here we fetch list of jobs and stages from UKG Pro Recruiting to Testlify
- Invite Candidates (Single/Multiple):
- Testlify sends invites to candidates, when in UKG Pro Recruiting candidate is moved to invitation stage.
- Result Retrieval:
- Upon completion, Testlify sends the results back to UKG Pro in PDF format /Link along with sortable score fields, which are automatically synced with the candidate profiles.
- When the score is updated on Testlify, Testlify send a webhook to UKG Pro Recruiting to update the score.
- Logs and Auditable Tracking:
- Detailed logs showing each candidate's invitation, enrollment, progress, and completion are maintained for auditing and process review.
- When candidate’s stage is changed in Testlify, like he enrolls, starts assessment, status change events are logged in UKG Pro Recruiting
- Recruiters can track candidate enrollment, progress, and completion within UKG Pro Recruiting.
2. User Flow in UKG Pro Recruiting
- HR Manager:
Logs into UKG Pro.
Selects a job or candidate profile.
Moves candidate to desired stage to trigger assessment
Tracks assessment status and views results directly in the system.
Job Applicant:
Receives assessment invitation.
Completes the assessment on Testlify.
- Results are automatically sent back to UKG Pro Recruiting.
3. FAQS
1. Finding your UKG Web Service SubDomain
Your UKG Web Service domain is located under the Web Services section. You can use the search bar to locate "Web Services." Alternatively, you can navigate to System Configuration -> Security -> Web Services in the UKG Pro UI
Look at any of the "web service endpoint URLs" and find your subdomain.
For example if your URL is, http://Servicet.ultipro.com/services/BIDataService then your subdomain is "Servicet"
2. Find your tenant name
Your tenant name can be found in the URL of your UKG Pro Recruiting account. For example, if you log in to UKG Pro Recruiting and your URL looks like: https://rec-demo-b.ultipro.com/USG1008IT124S/Dashboard
Your tenant w is: USG1008IT124S
3. Find your client ID and secret
Your client ID and secret can be found by reaching out directly to UKG Pro. Please reach out to your UKG Pro contact and ask them for your client ID and secret, and let them know they will need to enable the following scopes:
- recruiting.domain.application-import.create
- recruiting.domain.application-import.read
- recruiting.domain.applications.read
- recruiting.domain.applications.write
- recruiting.domain.candidate-import.create
- recruiting.domain.candidate-import.read
- recruiting.domain.candidates.read
- recruiting.domain.candidates.write
- recruiting.domain.configuration.read
- recruiting.domain.configuration.write
- recruiting.domain.offers.read
- recruiting.domain.offers.write
- recruiting.domain.opportunities.read
recruiting.domain.opportunities.write
4. Enter your information in the linking flow
Once you have your client ID and secret, enter the subdomain, tenant name, client ID and secret on the respective pages in the linking flow. Your UKG Pro Recruiting integration is now complete!