The UKG integration with Deel’s Global Payroll platform allows you to keep your HRIS system as the source of truth for employee information.
This means that information will be automatically pushed and pulled between the two platforms, eliminating the need for manual data entry.
In this article
Before you begin
Kindly note that the integration will sync automatically at 9am GMT.
Connecting UKG to Deel
Step 1: Open the UKG Integration
From the Deel home page, select the More icon and Apps tab search for UKG and click on connect to initiate integration.
Step 2: Get your account credentials
Login to your UKG account and follow these steps to retrieve your account credentials:
Base URL
Navigate to System configurations within your platform, access the Security section, and click on Web Services. Here, you'll find the "Business intelligence web service endpoint". Copy the base URL up to ".com" and ignore the subsequent details.
Username and Password
Still within the Security section, select Service account administration from the list of options. Enter a username and an email address here. A password will be automatically generated and sent to the provided email. For permissions, ensure all Web services have the View permission enabled, except for "Employee phone information" & "Third Party Pay Service", which should have "Add", "View", "Edit", and "Delete" permissions.
Customer API Keys
Return to the System configurations, locate Security and choose Web services. The "User API key" will be prominently displayed at the top. Copy this for your use.
Required Employee Fields in UKG
For employee data to sync successfully from UKG to Deel, certain fields must be populated in your UKG system for each employee:
Mandatory Fields
- Full-Time Equivalent (FTE): This field is required for all employees. It represents the employee's full-time equivalent status as a decimal:
- 1.0 = 100% full-time
- 0.5 = 50% part-time (or other fractional values as applicable)
- If this field is missing or blank for any employee, the sync will fail for those employees.
- Job History: This field must be populated for employees whose job information needs to be tracked.
How to Identify Missing Required Fields
If a sync fails or certain employees do not appear in Deel after syncing, check your UKG system:
- Go to the employee record in UKG.
- Verify that the FTE field is populated with a valid decimal value (e.g., 1.0, 0.5, 0.75)
- Verify that Job History is populated if the employee's job information is required
- If these fields are missing, populate them in UKG and re-initiate the sync
Once all required fields are populated, the integration will successfully sync the employee data to Deel on the next scheduled sync (or manual sync).
Step 3: Connect integration
After filling in all required information, click the Connect button to complete the integration of UKG to Deel.
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:
✅ Step 1: From the Deel home page, select the Hub icon and Apps tab to search for UKG.
✅ Step 2: Within UKG, find the Global payroll - employee data sync plugin and click on Manage.
✅ Step 3: On the Global payroll employee data sync drawer, select the entity to be used.
✅ Step 4: Click on the ellipses (three dots), select Disable Syncing and confirm the change.
Keep in mind that data syncs from UKG to Deel. When the sync is enabled, all the data manually entered in Deel will be overwritten by the data in UKG.
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.