Before you begin

You must be a UKG Pro administrator to set up this integration.

Need help? Let eqtble set up UKG Pro for you. We will schedule a call with whoever is the UKG Pro admin on your side.

Integrate eqtble with UKG Pro

1. Create an Integration System User (ISU)

  1. Navigate to Menu > System Configuration > Security > Service Account Administration.
  2. Click View UKG Pro service accounts
  1. Create a new service account for eqtble. Click Add.
  1. Take note of the Username and Password. You will need these later.

2. Configure permissions for the service account

Ensure that you give this API credential the necessary permission. If permissions are not configured correctly, certain actions/triggers may not work as intended - even if the connection is successful. See the required permissions below. Learn more about permissions for service accounts here.

  1. Add View permission for Company Configuration Integration.
  2. Click Service Account Permissions.
  3. Specify the following View permissions:
  • Company Configuration Integration
  • Employee Person Details
  • Employee Employment Information
  • Employee job
  • Employee contacts
  • Employee Compensation Details
  • PTO Plan Integration
  • Employee Job History Details
  • Personnel Integration
  • Employee Export
  1. Click Save.

3. Find your UKG Pro subdomain

  1. Log in to your UKG Pro portal
  2. Navigate to System Configuration, then Security and then Web Services
  3. Find the Web Service Hostname for your environment. It will look something like this:
  4. Make a note of the subdomain (e.g. subdomain in the example above) as you will need it later.

4. Find your Customer API Key

Your UKG Pro Customer API Key is a unique 4-character code that is used to identify your company.

  1. Log in to your UKG Pro portal
  2. Navigate to Service Account Administration.
  3. Copy the Customer API Key.

5. Integrate eqtble with UKG Pro

  1. Sign in to the eqtble app.
  2. Navigate to Organization Settings.
eqtble organization settings
  1. Select Integrations and select UKG Pro Recruiting
eqtble ukg pro
  1. Paste your Username, Password, API URL, and Customer API Key into the form.
eqtble ukg pro
  1. Click Save

Did we miss something? Have a question? Email us at to let us know.