Skip to main content

UKG Pro (UltiPro) Integration Guide for CRAs

Evan Nelson avatar
Written by Evan Nelson
Updated over 8 months ago

IMPORTANT NOTE

Effective January 1, 2023, UKG Pro (UltiPro) and UKG Ready (Kronos) are NOT available integrations for deverus partners who are not already partnered with UKG.


Overview

The UKG Pro (formerly UltiPro) integration with deverus facilitates seamless background check processing within UKG Pro’s Recruiting module. The End Client must complete the steps in the UKG Pro setup guide, but the CRA is responsible for configuring the Integration Manager (IM) account and handling testing. Alternatively, the CRA can opt for deverus to handle the project for an associated fee.


Timeline

Estimated Time to Configure:

  • Configuration by Client: Varies based on client’s familiarity with UKG Pro

  • IM Account Configuration by CRA: 1-2 business days after credentials are received

  • Configuration by deverus: 2 weeks total

Expected Go-Live Timeline:

  • Once all requirements are met, the typical go-live time is 2 weeks, including testing and validation.


Integration Connection Pricing

1. Self-Service Integration (No Cost)

We continue to provide comprehensive resources for self-implementation:

  • Detailed integration documentation

  • Step-by-step implementation guides

  • Access to our knowledge base

These resources remain completely free and are sufficient for most standard integration scenarios.

2. Premium 14-Day Support Package ($2,250)

For situations requiring direct assistance from our team, we offer a 14-day support package:

  • Direct access to our integration specialists

  • Technical troubleshooting and guidance

  • Implementation assistance

  • Configuration help

  • Testing support


Integration Requirements

Prerequisites for Setup

  • Partnership with UKG Pro: Required

  • UKG Pro Consultant Required: No

  • deverus: Integration Manager (IM) configuration (completed by CRA, or by deverus with SOW)

  • SwiftHire Mobile: Required


Configuration Options

Option 1: End Client Completes Steps in UKG Pro Integration Guide, CRA Configures IM

Required Information for Setup

Client must provide the following details to the CRA:

  • Recruiting URL

CRA must use the Recruiting URL to determine:

  • Tenant Alias

  • Login Host

  • Client Secret

Project Steps

  1. CRA provides the UKG Pro Integration Setup Guide to the client.

  2. Client follows the steps in the guide and provides their unique Recruiting URL to the CRA.

  3. CRA determines the correct Tenant Alias, Login Host, and Client Secret, and configures the account in Integration Manager.

  4. Roundtrip testing.


Option 2: deverus Completes Full Configuration

  • deverus handles the project from start to finish, including configuration of the Integration Manager account and testing.

  • Full configuration takes approximately 2 weeks, including testing.

  • Subject to the Premium 14-Day Support Package ($2,250) for configuration and testing.


Integration Manager (IM) Configuration Steps

Determine the Login Host and Client Secret

The CRA will use the client's Recruiting URL to determine the correct Identity Host (also referred to as the Login Host). The Recruiting URL typically follows this format:

http://{applicationURL}/TENANTALIAS

The {applicationURL} portion of the URL will indicate which Login Host and Client Secret should be used in Integration Manager based on the chart below:

Application URL

Login Host

Client Secret

or

signin.ultipro.com

MPbk1te4f7Ti8sfOGCK8s2FDkENvFkOG2SzTkZqDIvz_vgB6IWGonqu72Sw49FJM3FKppgV3UDS_MPEUktI6Fg

signin.ukg.net

h6ypb2ps0sid6ap2C7d1BzBtc1u4qBCe312rg3yp90DgdxpfgfBbd3dfyFf36qBkefb4ogDFseDxh8BeoBr6Berev5

signin.ultipro.ca

AKYr0FRp42MKoswBF5VMd9OYBdB3ZRJduULzuw7IAfhfKkSyRmD1a-sUE3hmQxDQI94kwNzAaCM0ENqahf6avM8

Once the correct Login Host and Client Secret are identified, proceed with configuring the IM account.


Steps for CRA or deverus Integration Team

  1. Login to deverus -> Integration tab -> Home

  2. Select the UKG Pro tile

  3. Select "Configure Existing Client"

  4. Type in the name of the top/parent client account and select it

  5. Choose the Send Results option:

    • Report Link with Login

    • Report Link without Login

  6. Toggle SwiftHire to On

  7. Click Next

  8. Enter UKG Pro credentials:

    • Client ID (is always deverusdev)

    • Client Secret

    • Client Name (enter the name of the client as you have it in deverus)

    • Tentant Alias (from the end of the client's Recruiting URL)

    • Default Report URL (https://{CRA}.screening.services)

    • Login Host (either 'signin.ultipro.com,' 'signin.ultipro.ca,' or 'signin.ukg.net')

    • Organization Unit Number (can be '0' - zero)

  9. Click 'Save Settings'


No Mapping Necessary

The UKG Pro integration utilizes a webform where the Location(s) and Package(s) automatically populate into UKG when the user submits a background check request.


Test the Integration

  1. Have the client submit a test applicant for a background check. They should receive a "Success" message in response to submitting.

  2. Log into deverus as the client to confirm a SwiftHire invitation has been created. Have the client confirm they see 'Pending Candidate' status.

  3. Complete the SH invite as the applicant by logging in as the client and clicking on the Waiting status. Have the client confirm they see 'Pending' status.

  4. Complete the report from the Admin module, and have the client confirm they see 'Complete' status along with the report URL.


Guides & Documentation

  • UKG Pro Configuration Guide

  • Troubleshooting Common Errors: [Article HERE]

  • UKG Pro Data Centers:

Did this answer your question?