Set Up UKG Pro Recruiting Integration with Testlify

The UKG Pro Recruiting integration with Testlify automates assessment delivery: when a candidate reaches the Invitation Stage in UKG Pro, Testlify sends the assessment automatically. When the candidate finishes, Testlify syncs the results — a PDF report and sortable score fields — back to their UKG Pro candidate profile.

Before you begin

Collect the following credentials from UKG Pro before starting:

  • Web Service Subdomain — found under System Configuration > Security > Web Services in UKG Pro (see FAQ 1 below)
  • Tenant name — visible in the URL of your UKG Pro Recruiting account (see FAQ 2 below)
  • Client ID and Client Secret — request from your UKG Pro representative; ask them to enable the required API scopes (see FAQ 3 below)

Step 1: Connect UKG Pro Recruiting to Testlify

  1. In Testlify, go to Settings and select Integrations.

  1. Scroll down and select UKG Pro Recruiting.

  1. The linking flow opens. Enter your Web Service Subdomain, Tenant name, Client ID, and Client Secret on the respective screens. See the FAQs below for help locating each value.

  1. Click Save. A confirmation page appears.

  1. Click Continue. Testlify redirects you to the Integrations page, where UKG Pro Recruiting now appears as a connected integration.

Step 2: Link a job requisition to an assessment

  1. Create or open an assessment in Testlify.

  1. In the assessment settings, select a Job Requisition from UKG Pro Recruiting and configure the automation stages:
    • Invitation Stage — the hiring stage at which Testlify automatically sends the assessment to candidates
    • Completion Stage — the stage to which the candidate moves after completing the assessment

  1. Click Link to connect UKG Pro Recruiting to the assessment.

  1. Click Save on the assessment.
  2. In the UKG Pro Recruiting dashboard, move a candidate to the Invitation Stage. Testlify automatically sends that candidate an assessment invite.

  1. When the candidate completes the assessment, Testlify sends the results back to UKG Pro as a PDF or shareable link, with sortable score fields automatically synced to the candidate's profile.

FAQs

1. Find your UKG Web Service subdomain

  1. In UKG Pro, go to System Configuration > Security > Web Services, or search for Web Services in the search bar.

  1. Find any web service endpoint URL and copy the subdomain. For example, in http://Servicet.ultipro.com/services/BIDataService, the subdomain is Servicet.

2. Find your tenant name

Your tenant name appears in the URL of your UKG Pro Recruiting account. For example:

https://rec-demo-b.ultipro.com/USG1008IT124S/Dashboard

In this example, the tenant name is USG1008IT124S.

3. Find your Client ID and Client Secret

Contact your UKG Pro representative and request your Client ID and Client Secret. Ask them to enable the following API 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. Complete the linking flow

Once you have all four credentials, enter your subdomain, tenant name, Client ID, and Client Secret on the respective screens in the linking flow. The integration is complete when UKG Pro Recruiting appears as connected on the Integrations page.

Need help? Contact support.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us