All Collections
Authentication Guides
ATS
UKG Pro Recruiting - How do I link my account?
UKG Pro Recruiting - How do I link my account?

How to link your UKG Pro Recruiting in Merge

Matthew Ho avatar
Written by Matthew Ho
Updated over a week ago

Overview

The UKG Pro Recruiting integration requires a subdomain, tenant name, client ID, and secret to authenticate. This guide will walk you through finding or creating those credentials within UKG.

Prerequisites

Please ensure you fulfill all the requirements to set up the integration:

  • You are an Integration Administrator in your company's UKG Pro Recruiting instance, or someone has shared their access with you.

Instructions

Step 1: Finding your UKG Web Service Domain

  1. In your search bar, search for Web Services

  2. 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"

Step 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:

Your tenant name is: USG1008IT124S

Step 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.applications.read

  • recruiting.domain.applications.write

  • 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

Step 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!

Did this answer your question?