UKG Ready integration guide – Deel

The UKG Ready 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 Ready so that you can sync data between them.

Before you begin

To successfully set up the UKG Ready integration, you’ll need:

A user with an admin role on Deel
A service user role on UKG Ready
A Global Payroll entity on Deel with time off policies

We recommend checking the UKG Ready integration reference to understand the integration's features and limitations before starting to follow this guide.

Step 1. Prepare UKG Ready

In this section, we’ll guide you through how to configure UKG Ready so that you can connect to it.

To connect UKG Ready to Deel, you’ll need to prepare your account credentials, such as the base URL, username, password, company short name, and API key.

To get your API key:

Go to Settings > Global Setup > Company Setup, then navigate to the Login Config tab.
Generate and copy your API key.

Step 2. Connect the integration

In this section, we’ll guide you through how to connect Deel to UKG Ready.

To connect to UKG Ready:

In Deel, go to More > Apps and search for UKG Ready.
On the UKG Ready integration page, click Connect UKG Ready.

At the Connect to UKG Ready step, enter your account credentials and click Continue.

UKG Ready account credentials	Where to find it
Base URL	Your UKG Ready staging environment URL
Username	The username of your service user
Company short name	Settings > Global Setup > Company Setup on the Company Info tab.
Password	The password of your service user
Customer API key	Settings > Global Setup > Company Setup on the Login Config tab.

At the Notification settings step, enter one or more email addresses where to receive integration notifications, then click Connect.

The integration is now connected and you can start to configure the integration.

Step 3. Configure the integration

In this section, we’ll guide you through configuring the integration so that data can sync successfully.

After connecting UKG Ready, you need to configure:

Employee data sync
Time off sync
Payslip sync

Set up employee data sync

This plugin automatically syncs direct employee data (onboarding, amendments, and terminations) to Deel.

To configure the employee data sync plugin:

Set up the plugin
Enable the sync

Set up the employee data sync plugin

Before enabling the employee data sync plugin, you have to set it up.

To set up the employee data sync plugin:

From the UKG Ready integration page, go to the Plugins tab.
Click Enable on the Employee data sync plugin.
On the Global payroll employee data sync page, click Add Entity.
On the Entity details step, select an entity and team.

On the Global field mapping step, ensure the mandatory Deel fields are mapped with UKG Ready values and optional ones (cost centers, employee custom fields, or country-specific fields).

On the Test and fix wizard, we recommend running a test to identify possible issues early, but you can skip the test by clicking Continue.
On the Enable sync step, turn on sync for your pay group and click Complete setting.

Enable the employee data sync plugin

After setting up the employee data sync plugin, you need to enable it.

To enable the employee data sync plugin:

From the UKG Ready integration page, go to the Plugins tab.
Click Enable on the Global Payroll - Employee data sync plugin.
On the Global payroll employee data sync page, click Enable.

The employee data sync plugin is configured; employee data will automatically sync between UKG Ready and Deel.

Configure the time off plugin

This plugin syncs your direct employees' time off logged in UKG to Deel to be used to process payroll.

The employee data sync is required to configure the time off sync.

To configure the time off plugin:

From the UKG Ready integration page, go to the Plugins tab.
On the Global Payroll - Time off sync plugin, click Enable.
On the Global Payroll - Time Off Sync page, click Configure on your selected Global Payroll entity.

Match each Deel time off type to at least one time off type from your HRIS.

Click Confirm.
On the Enable the sync modal, click Enable sync.

The time off plugin is configured and logged direct employee time off will begin syncing.

Configure the auto sync of payslip plugin

This plugin allows you to sync payslips to UKG Ready so that your team can have access to payslip and tax documents.

To configure the auto sync of payslip plugin:

From the UKG Ready integration page, go to the Plugins tab.
On the Global Payroll - Auto sync of payslip plugin, click Enable.

The auto sync of payslip plugin is configured, payslips will begin syncing.

Step 4. Sync data manually

Automatic syncs occur daily, one way from Deel to UKG Ready, but you can manually trigger a sync:

If you’ve made important changes and need them to sync immediately
If you notice missing data or errors that suggest that the last sync didn’t complete correctly

To sync data, go to the UKG Ready integration page and click Sync UKG Ready.

Recent changes in employee data will be synced from Deel to UKG Ready.

UKG Ready integration reference

This section provides information about the integration's capabilities and limitations. You can use it to understand whether the integration can sync the data you need to sync.

Supported contract type

The UKG Ready integration supports the Global payroll contract type.

Supported sync entities

The UKG Ready integration supports the sync of the following entities:

Employee data
Time off
Payslips
Compensation info

Mandatory sync fields

Mandatory Deel fields are applied globally; ensure they are mapped with UKG Ready values.

The UKG Ready integration supports the sync of the following mandatory fields:

Mapped from Deel	Description	Mapped by default to
First Name	Employee’s legal first name	First Name
Last Name	Employee’s legal last name	Last Name
Employee Number	Employee’s identifier	Employee Id
Address Line 1	Employee’s primary address	Address Line 1
City	City where the employee is based	City
Zip code	Postal/ZIP code for the employee’s address	Zip Code
Pay rate	Employee’s current compensation amount	Compensation Information Amount
Pay rate time frame	Frequency of pay rate	Compensation Information Time Period
Compensation Effective date	Date when the current pay rate takes effect	Compensation Information Effective From
Country	Country where the employee is based	Country
Job Title	Employee’s job title	JobDetail Jobs (HR)
Job Info Effective date	Date when the employee’s current job details (title, etc.) were updated	Date Started
Email	Employee’s primary work email address	Primary Email
Start Date	Employee’s official hire/start date	Date Started
Full time percentage	Employee’s FTE status (e.g., 100% for full-time, 50% for part-time)	FTE
Employee type	Classification (e.g., full-time, part-time)	Employee Type
Employment Effective date	Date when the current employment type took effect	Date Started

In this article