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.
Address mapping and integration behavior
What the UKG Integration Syncs
The UKG integration syncs specific employee data fields from UKG to Deel. Understanding what is and isn't synced helps prevent confusion about data flow and approvals.
Address Mapping Limitations
- Contract Address only: The integration syncs the Contract Address field only from UKG to Deel.
- Not synced: Personal home addresses and postal addresses are NOT synced or updated by the integration.
- Manual entries: If a home or postal address appears in Deel, it was entered manually through the Deel UI, not from the UKG sync.
Approval Request Triggers
Understanding when approval requests appear in Deel helps clarify what data came from the integration versus manual entries.
- Synced updates (no approval needed): Changes synced directly from UKG to Deel (such as contract address updates or department changes) apply immediately and do not trigger an approval request.
- Manual entries (approval triggered): If an approval request for an address or profile change appears in Deel, it means the change was entered manually in the Deel UI by a worker or admin—it did not originate from the UKG sync.
Example: If a worker's contract address changes in UKG, it syncs to Deel automatically with no approval step. But if a worker manually updates their home address directly in the Deel UI, Deel may trigger an approval workflow depending on your organization's settings.
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.