UKG Ready HRIS Integration

The UKG Ready HRIS integration allows you to sync HRIS data between UKG Ready and your application through Kombo’s unified API. The tool slug for this connector is ukgready.

Guides and Resources

Connection Setup Guide

Step-by-step instructions to connect your UKG Ready account to Kombo.

Supported Features & Coverage

Models
Actions
Features
Create Employee with Form

Legal Entities

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
address

Work Locations

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name

Employees

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_number
first_name
last_name
display_full_name
work_email
personal_email	The personal email is not exposed via the API.
mobile_phone_number
ssn
gender
ethnicity
employment_status
employment_type
weekly_hours	Calculated by multiplying “standard_work_day” by 5 days.
avatar
work_location_id
legal_entity_id
manager_id
home_address
date_of_birth
start_date
termination_date
custom_fields
integration_fields

Absence Types

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
unit
half_days_supported
exact_times_supported

Absences

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
start_date
end_date
start_time
end_time
amount
unit
status
type_id

Employments

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
job_title
pay_rate
pay_period
pay_currency
effective_date
custom_fields
integration_fields

Groups

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
type
parent_id

Timesheets

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
started_at
ended_at
timezone
payable_hours
approval_status

Pay Runs

Field	Notes
id
remote_id
changed_at
remote_deleted_at
start_date
end_date
legal_entity_id

Payslips

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
pay_run_id

Salary Types

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name

Payslip Line Items

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
payslip_id
salary_type_id
amount

Employee <> Group

Field	Notes
employee_id
team_id
id
changed_at
remote_deleted_at

Input Field	Notes
staffing_entity_id
properties

Feature	Notes
API Passthrough
Scope Testing
Per Model Tests
Delta Syncs
Custom Field Explorer
Employees
Employments
Connection Guide
Employment History
Group Types
COST_CENTER

This integration supports multiple employee creation forms for different use cases:

import-tool
v2

text

Username
Username for the employee. If not provided, a random value is generated.

text

External Id

text

New Employee Id

text

Badge Id

text

Badge Id 2

text

Badge Id 3

text

EIN Tax Id

text

EIN Name

single_select

Primary EIN
Set to “Y” to mark this EIN as primary for the employee

text

Employee Sync

text

Salutation

text

required

First Name
Maximum 75 characters
Unified field: first_name

text

Middle Initial

text

required

Last Name
The last name of the employee
Unified field: last_name

text

Nick Name

Social Security
Valid format: 111-11-1111

Allow Change To Social Security
Setting value to “Y” allows changing Social Security Number

Social Insurance Number
Available only for Canada companies. Valid formats: 111-111-111 or 111111111

text

Primary National ID Type

text

Tax File Number
Available only for Australian companies. 8 digits

Social Security Number (France)
National ID number for France. Available only for French companies. 13-15 digits

text

Private Email
The private email address of the employee
Unified field: private_email

text

Secondary Email

text

Personal Email

text

Security Question

text

Security Question Answer

Disable Only Login Using SSO
Maximum 25 characters

text

Locale

text

Home Phone

text

Work Phone

text

Cell Phone
The mobile phone number of the employee
Unified field: mobile_phone_number

single_select

Primary Phone
Valid Values: Home Phone, Work Phone, Cell Phone. Abbreviations H, W, C will also be accepted.

text

Address 1
The street address of the employee
Unified field: home_address.street_1

text

Address 2
Alternative address
Unified field: home_address.street_2

text

Address 3
Alternative address

text

City
Maximum 25 characters
Unified field: home_address.city

text

State
Two character state code (e.g., NJ for New Jersey) or NA for non-USA
Unified field: home_address.state

text

Zip
Valid formats: 11111 or 11111-1111
Unified field: home_address.zip_code

text

Country
The uppercase two-letter ISO country (e.g., DE)
Unified field: home_address.country

text

Address Latitude

text

Address Longitude

text

Status

text

Status External Id

text

Employee Type

text

Standard Work Day
Length of standard work day in HH:MM or HH.00 format (e.g., 8:00 or 8.00)

text

Pay Type

text

Pay Type External Id

text

Default Shift

single_select

Medical Eligibility

single_select

Dental Eligibility

single_select

Dependent Benefits Eligibility

text

Union

text

Pay Grade

text

Step

date

required

Hired
Start date of the employee. Also considered to be the hire date
Unified field: start_date

date

required

Started

date

Birthday
The employee’s date of birth
Unified field: date_of_birth

date

Review

date

Seniority

date

Benefits

date

Terminated
REQUIRED if employee has been terminated

date

Re Hired

date

Frozen Benefit

date

Retirement

date

Custom Date 1

date

Custom Date 2

date

Custom Date 3

date

Custom Date 4

date

Custom Date 5

text

Time Zone

text

First Screen

text

Root Cost Center 1

date

Root Cost Center 1 Effective From

text

Root Cost Center 2

date

Root Cost Center 2 Effective From

text

Root Cost Center 3

date

Root Cost Center 3 Effective From

text

Root Cost Center 4

date

Root Cost Center 4 Effective From

text

Root Cost Center 5

date

Root Cost Center 5 Effective From

text

Root Cost Center 6

date

Root Cost Center 6 Effective From

text

Root Cost Center 7

date

Root Cost Center 7 Effective From

text

Root Cost Center 8

date

Root Cost Center 8 Effective From

text

Root Cost Center 9

date

Root Cost Center 9 Effective From

text

Root Cost Center 10

date

Root Cost Center 10 Effective From

text

Limit Cost Center List 1

date

Limit Cost Center List 1 Effective From

text

Limit Cost Center List 2

date

Limit Cost Center List 2 Effective From

text

Limit Cost Center List 3

date

Limit Cost Center List 3 Effective From

text

Limit Cost Center List 4

date

Limit Cost Center List 4 Effective From

text

Limit Cost Center List 5

date

Limit Cost Center List 5 Effective From

text

Limit Cost Center List 6

date

Limit Cost Center List 6 Effective From

text

Limit Cost Center List 7

date

Limit Cost Center List 7 Effective From

text

Limit Cost Center List 8

date

Limit Cost Center List 8 Effective From

text

Limit Cost Center List 9

date

Limit Cost Center List 9 Effective From

text

Limit Cost Center List 10

date

Limit Cost Center List 10 Effective From

text

Default Cost Center 1

text

Default Cost Center 2

text

Default Cost Center 3

text

Default Cost Center 4

text

Default Cost Center 5

text

Default Cost Center 6

text

Default Cost Center 7

text

Default Cost Center 8

text

Default Cost Center 9

text

Default Cost Center 10

date

Job Last Changed

text

Access

single_select

Access On New Only

text

Accruals

date

Accruals Profile Effective From

single_select

Accruals On New Only

text

Attestation Profile

date

Attestation Profile Effective From

single_select

Attestation Profile On New Only

text

Beacon (Mo) Profile

single_select

Beacon (Mo) Profile On New Only

text

Benefit Profile

date

Benefit Profile Effective From

single_select

Benefit Profile On New Only

text

Competency Profile

single_select

Competency Profile On New Only

text

Counter Distribution Profile

date

Counter Distribution Profile Effective From

single_select

Counter Distribution Profile On New Only

text

Dashboard Layout Profile

date

Dashboard Layout Profile Effective From

single_select

Dashboard Layout Profile On New Only

text

Holiday

single_select

Holiday On New Only

text

InTouch Schedule Restrictions Profile

single_select

InTouch Schedule Restrictions Profile On New Only

text

Labor Distribution Profile

single_select

Labor Distribution Profile On New Only

text

Onboarding Profile

single_select

Onboarding Profile On New Only

text

Pay Calculations

date

Pay Calculations Profile Effective From

single_select

Pay Calculations On New Only

text

Pay Period

single_select

Pay Period On New Only

text

Pay Prep

single_select

Pay Prep On New Only

text

Points Profile

single_select

Points Profile On New Only

text

PST Delivery Policy

single_select

PST Delivery Policy On New Only

text

PST Population Profile

single_select

PST Population Profile On New Only

text

Retirement Plan

single_select

Retirement Plan On New Only

text

Role

single_select

Role On New Only

text

Second Retirement Plan

single_select

Second Retirement Plan On New Only

text

Employee Perspectives Profile

date

Employee Perspectives Profile Effective From

single_select

Employee Perspectives Profile On New Only

text

Work Schedule

date

Work Schedule Start Pattern On

single_select

Work Schedule Start Pattern Type
REQUIRED if “Schedule Pattern On” is specified. Default Value - “Day” is set if empty or CLEAR.

single_select

Work Schedule On New Only

text

Scheduler

single_select

Scheduler On New Only

text

Security

single_select

Security On New Only

text

Timesheet

single_select

Timesheet On New Only

text

Timesheet Autopopulate

single_select

Timesheet Autopopulate On New Only

text

Training Profile

single_select

Training Profile On New Only

text

Performance Review Profile

single_select

Performance Review Profile On New Only

text

W2 Delivery Policy

single_select

W2 Delivery Policy On New Only

text

Workday Breakdown

date

Workday Breakdown Profile Effective From

single_select

Workday Breakdown On New Only

text

Working Time Regulations

single_select

Expense Tracking Profile On New Only

text

Expense Tracking Profile

text

Data Retention Profile

date

Data Retention Profile Effective From

single_select

Data Retention Profile On New Only

text

Hardware RSI Hand Template

text

Hardware Asher PIN

text

Hardware ZK Password

text

Hardware ATS PIN

text

Hardware ATS Security Level

text

Hardware InTouch PIN

single_select

Hardware InTouch Security Level

single_select

Gender
The gender of the employee
Unified field: gender

text

Eye Color

text

Height

single_select

Disability

single_select

Citizenship

single_select

Ethnicity

single_select

EEO Classification

single_select

EEO-4 Classification

single_select

EEO-4 Function

text

Primary Language

text

Secondary Language

single_select

Smoker

single_select

Seasonal

single_select

FT Student

text

Referral

single_select

Visa Type

text

Recruiter

text

Worker Type

text

Manager 1

text

Manager 1 EIN Tax Id

text

Manager 1 EIN Name

text

Manager 2

text

Manager 2 EIN Tax Id

text

Manager 2 EIN Name

text

Manager 3

text

Manager 3 EIN Tax Id

text

Manager 3 EIN Name

text

Manager 4

text

Manager 4 EIN Tax Id

text

Manager 4 EIN Name

text

Manager 5

text

Manager 5 EIN Tax Id

text

Manager 5 EIN Name

text

Manager 6

text

Manager 6 EIN Tax Id

text

Manager 6 EIN Name

single_select

Managed Cost Centers Enabled

single_select

Managed Cost Centers Allow Save Of Other Cost Centers

single_select

Managed Cost Centers Restrict Editing Approved Timesheets

text

Time Entry Extra 1

text

Time Entry Extra 2

text

Time Entry Extra 3

text

Time Entry Extra 4

text

Time Entry Extra 5

text

Account Extra 1
Additional employee attributes - Maximum 255 characters

text

Account Extra 2
Additional employee attributes - Maximum 255 characters

text

Account Extra 3
Additional employee attributes - Maximum 255 characters

text

Account Extra 4
Additional employee attributes - Maximum 255 characters

text

Account Extra 5
Additional employee attributes - Maximum 255 characters

date

Account Extra 1 Effective From

date

Account Extra 2 Effective From

date

Account Extra 3 Effective From

date

Account Extra 4 Effective From

date

Account Extra 5 Effective From

single_select

Account Extra Mode
Controls whether account extra field entries are added as new records (ADD) or overwrite existing (SET). Default: ADD

text

Rate X Base

date

Rate X Base Eff Date

text

Rate X Table

text

Rate X Ext Z Table

text

Rate X Ext Z Type

text

Base Compensation

single_select

Base Compensation Type

text

Base Compensation Amount Earning Code

text

Base Compensation Hours Earning Code

date

Base Compensation Effective From

text

Autopay Schedule

date

Autopay Schedule Effective From

text

Emergency Contact First Name

text

Emergency Contact Last Name

text

Emergency Contact Relationship
REQUIRED if any Emergency Contact fields are defined (unless disabled in company settings)

text

Emergency Contact Work Phone

text

Emergency Contact Home Phone

text

Emergency Contact Cell Phone

text

Emergency Contact Address 1

text

Emergency Contact Address 2

text

Emergency Contact Address 3

text

Emergency Contact City

text

Emergency Contact State

text

Emergency Contact Zip

text

Emergency Contact Country

text

Accruals X Def

text

Accruals X Hrs

date

Last Pay Period End Date

text

Default Workers Comp Code

single_select

Default Workers Comp Code On New Only

single_select

Is W2

single_select

Is 1099

single_select

Is Draw

text

Reciprocity Override

single_select

Is Commission Only (Canada)

text

Add To New Hire Export

single_select

Add To New Hire Export On New Only

text

Actual Marital Status

text

HR Action History Type

Some optional form fields are referencing the following data models:

Employees
Legal Entities

Consider enabling these in your scope configuration.

text

required

Username
The username for the employee.

text

required

First Name
The first name of the employee
Unified field: first_name

text

required

Last Name
The last name of the employee
Unified field: last_name

text

Middle Name

text

Nickname (Preferred Name)

text

Private Email
The private email address of the employee
Unified field: private_email

text

Secondary Email

text

Employee ID
External Employee ID

single_select

EIN
The EIN (legal entity) to create the employee under, referencing a legal entity synced from UKG Ready. If omitted, UKG Ready assigns the company default EIN.
Unified field: legal_entity_id
References /v1/hris/legal-entities?remote_model=legal_entity

object

Home Address

Show properties

text

required

Country
The country of the employee. Use the ISO 3166-1 alpha-3 code.

text

Street 1
The street address of the employee
Unified field: home_address.street_1

text

Street 2
The street address of the employee
Unified field: home_address.street_2

text

City
The city of the employee
Unified field: home_address.city

text

State
State/Province (Max 3 characters). Only for supported Countries.
Unified field: home_address.state

text

ZIP Code
The ZIP code of the employee
Unified field: home_address.zip_code

object

Phone Numbers

Show properties

text

Mobile Phone Number
The mobile phone number of the employee
Unified field: mobile_phone_number

text

Home Phone

text

Work Phone

multi_select

Managers
The managers for the employee.

text

National Insurance Number

Social Insurance Number

Social Security Number

checkbox

Add to New Hire Export

object

required

Important Dates

Show properties

date

required

Start Date
Start date of the employee. Also considered to be the hire date
Unified field: start_date

date

Date of Birth
The employee’s date of birth
Unified field: date_of_birth

date

required

Hired Date

date

Re-Hired Date

date

Terminated Date

Integration Variants

Current connector: UKG Ready For UKG Ready, we also offer the following other connector variants:

UKG Ready ATS

UKG Ready for the ATS category

General

Features

Guides

HRIS API Reference

Payroll API Reference

General API Reference

DATEV

UKG Ready HRIS Integration

Guides and Resources

Connection Setup Guide

Supported Features & Coverage

Integration Variants

UKG Ready ATS

​Guides and Resources

Connection Setup Guide

​Supported Features & Coverage

​Integration Variants

UKG Ready ATS

Guides and Resources

Supported Features & Coverage

Integration Variants