1. Betterworks
  2. How-to
  3. Integrations

UKG Pro Integration

Contents

Overview

Organizations can utilize the Betterworks UKG Pro integration to sync user data changes from UKG to Betterworks on a regular basis. This automates the process of:

  • Creating new users
  • Updating user information (i.e. change in manager, department, etc.)
  • Deactivating users who are no longer with your organization

The UKG Pro integration is incremental, meaning that during the first sync, it will not pull in all users from your organization's UKG Pro instance. It will only track incremental changes (new users, deactivated users, and user updates) that occur on and after the date of the first sync. As such, you'll want to ensure that all user data is imported into Betterworks or updated using another method before connecting to UKG Pro.  

Example:

  • On Jan. 1st, Jane Smith imported all of Acme Corp.’s employees into Betterworks via a manual CSV upload. The upload created 98 new users, making the total # of users in Acme Corp.’s Betterworks instance 100.
  • Between Jan. 2nd and June 30th, Acme Corp. hired 20 more employees.
  • On July 1st, Jane connected Acme Corp.’s UKG Pro instance to Betterworks via our UKG Pro integration. However, she had not done any more data imports during the previous months or immediately before enabling the integration.
  • On July 2nd, Acme Corp. hired 1 more employee. Due to the UKG Pro integration, 1 more user was created in Betterworks, bringing the total # of users to 101. However, the total # of users should have been 121 to match the # of employees in Acme Corp.’s UGK Pro instance.

Setup

1. Contact the Betterworks Support Team — support@betterworks.com. They will work with you to ensure that all user data is imported into Betterworks or updated and collect other information necessary for the backend configuration. 

2. The Support Team member will let you know when to enter your UKG Pro details into Betterworks. At that time:

In UKG Pro

a. Create a Service Account by going to:

System Configuration → Security → Service Account Administration

b. Grant permissions to the following 3 categories: 

  • Company Configuration Integration
  • Employee Export
  • Personal Integration

c. Retrieve the Customer API Key and the base API URL (aka the API Host URL) by going to:

System Configuration → Web Services

In Betterworks

d. Go to:

Admin → Platform Configuration → Integrations → Third-party Integrations → UKG → Setup

e. Enter the details and save.

Note: When you enter the API Host URL, add an 's' to make it "https://". The 's' triggers a secure connection. 

Mapping

The following mapping is automatic. 

Note: UKG Pro allows organizations to customize label names. As such, the label names shown above may not be an exact match to your configuration. However, API names are static.  

Data Sync

Once the connection is created the sync will initiate between UKG Pro and Betterworks. Following the first sync, a new sync occurs every 24 hours from the time of the last sync.

Troubleshooting

  • Sync Failure: If the data sync between UKG Pro and Betterworks fails, verify that the credentials provided for UKG Pro and ensure that the UKG Pro API is accessible and not experiencing any downtime or connectivity issues.
  • Missing Data: Ensure that user accounts or data meet the criteria for syncing, including being active and not excluded based on filters or conditions. Check data mapping or transformation rules in the integration settings.
  • Incorrect Credentials Error: Check for typos in the username, password, API URL, and API Key.

FAQs

How often does the data sync occur between UKG Pro and Betterworks?

The data sync between UKG Pro and Betterworks occurs every 24 hours from the time of the last sync. This ensures that updates to user information, new users, and user deactivations are reflected in Betterworks regularly.

What happens if there is a failure in the data sync process?

In case of a failure in the data sync process, it is essential to troubleshoot the issue by verifying the credentials, connectivity, and configuration settings. Once the issue is resolved, the sync will resume automatically based on the defined schedule.

How can I track the status and progress of the data sync between UKG Pro and Betterworks?

Betterworks sends an automated email notification to the Technical Contact if there is an error. The notification contains a report listing the errors and links to this article to provide solutions.