Setting Up The UKG Integration For Global Payroll

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

The integration will sync automatically daily 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.

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

1. In UKG Pro, go to System Configurations > Security > Web Services.

2. Locate the Business Intelligence Web Service Endpoint.

3. Copy the base URL up to “.com”.

Username and Password (Service Account)

1. Still in the Security section, select Service Account Administration.

2. Create a new service account by entering a username and email address.
    

   

   A password will be automatically generated and sent to the email provided.

3. Assign the following required permissions to the service account:

Required Employee Fields in UKG Pro

For employee data to sync successfully from UKG Pro to Deel, certain fields must be populated in your UKG Pro 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 in UKG Pro, the sync will fail for those employees in Deel.
• Job History: This field must be populated for employees whose job information needs to be synced to Deel.

Troubleshooting Sync Failures

If employees do not appear in Deel after connecting the integration, verify:

1. The FTE field is populated for all employees with a valid decimal value (e.g., 1.0, 0.5, 0.75)
2. The Job History field is populated where applicable
3. The service account has the required permissions listed above

Once these fields are populated in UKG Pro, initiate a manual sync or wait for the next automatic daily sync at 9am GMT.

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:

1. 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. 

An entity can only be mapped once. To change a mapped entity, please contact Deel support

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.

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.