The UKG Pro integration with Deel’s Global Payroll platform allows you to keep your HRIS system as the source of truth for employee data, eliminating the need for manual data entry.
This article explains how to configure Deel and UKG Pro so that you can sync data between them.
In this article
Here’s what you’ll find in this article:
- Before you begin
- Step 1. Prepare UKG Pro
- Step 2. Connect the integration
- Step 3. Configure the integration
- Frequently Asked Questions
Before you begin
To successfully set up the UKG Pro integration, you’ll need:
- A user with an admin role on Deel
- An admin role on UKG Pro
- A Global Payroll entity on Deel with time off policies
Step 1. Prepare UKG Pro
In this section, we’ll guide you through how to configure UKG Pro so that you can connect to it.
To connect UKG Pro to Deel, you’ll first need to prepare your account credentials, including the base URL, username and password, and Customer API keys.
Base URL
-
In UKG Pro, go to System Configurations > Security > Web Services.
-
Locate the Business Intelligence Web Service Endpoint.
-
Copy the base URL up to “.com”.
Username and Password (Service Account)
-
Still in the Security section, select Service Account Administration.
-
Create a new service account by entering a username and email address.
A password will be automatically generated and sent to the email provided. -
Assign the following required permissions to the service account:
| Web Service | Required Access |
|---|---|
| Employee Contacts | View |
| Company Configuration Integration | View |
| Employee Compensation Details | View |
| Employee Job History Details | View |
| Employee Person Details | View |
| Employee Export | View |
| Global Employee Direct Deposit | View |
| Payroll Integration | View |
| Personnel Integration | View |
Customer API Keys
1. Return to the System configurations, locate Security, and choose Web services.
2. Copy the Customer API key
Step 2. Set up the integration
In this section, we’ll guide you through how to connect Deel to UKG Pro.
To connect to UKG Pro:
- In Deel, go to More > Apps and search for UKG Pro.
2. On the UKG Pro integration page, click Connect UKG Pro.
3. After filling in all required information, click Connect to complete the integration.
Step 3. Configure the integration
In this section, we’ll guide you through configuring the integration so that data can sync successfully.
To set up the Global Payroll Employee Sync:
1. Select the Plugins tab and then click Manage Global Payroll employee sync.
2. Select an entity, or click Add to add a new one.
3. Complete the field mapping
Frequently Asked Questions
[ACCORDION] Can workers be managed manually on Deel if UKG stops working?
Even if a client’s HRIS software stops working, onboarding and offboarding workers is still possible manually on Deel. To manage employee data manually, the sync with the HRIS software must be temporarily disabled.
To disable the sync:
1. From the Deel home page, select the More icon and Apps tab to search for UKG.
2. Within UKG, find the Global payroll - employee data sync plugin and click on Manage.
3. On the Global payroll employee data sync drawer, select the entity to be used.
4. Click on the ellipses (three dots), select Disable Syncing, and confirm the change.
Before re-enabling the sync, make sure:
- To add the worker(s) to UKG first.
- That the email and employee numbers in both systems match.