UKG Pro HRIS Integration

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

Guides and Resources

Connection Setup Guide

Step-by-step instructions to connect your UKG Pro 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
custom_fields
integration_fields

Work Locations

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
address

Employees

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_number
first_name
last_name
nationality
job_title
work_email
personal_email
mobile_phone_number
ssn
gender
ethnicity
marital_status
employment_status
employment_type
weekly_hours
work_location_id
legal_entity_id
manager_id
home_address
bank_accounts
date_of_birth
start_date
termination_date
remote_created_at
custom_fields
integration_fields

Absence Types

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
unit

Employments

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

Groups

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
type
custom_fields
integration_fields

Time Off Balances

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
type_id
balance
balance_unit
used
used_unit

Staffing entities

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
model_type
description
status
employment_types
number_of_openings
parent_id
remote_url
remote_created_at
remote_updated_at
custom_fields
integration_fields

Pay Runs

Field	Notes
id
remote_id
changed_at
remote_deleted_at
start_date
end_date

Payslips

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
pay_run_id
totals_gross_pay
totals_net_pay
totals_paid_amount
custom_fields
integration_fields

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
amount_ytd	Year-to-date amounts are rounded to the currency’s decimal places using mathematical rounding (half away from zero). The unrounded values are available as custom fields on the line item: `amountYtd` for earnings and taxes, and `employeeAmountYtd` for deductions.
custom_fields
integration_fields

Employee <> Group

Field	Notes
employee_id
team_id
id
changed_at
remote_deleted_at

Staffing Entity <> Location

Field	Notes
staffing_entity_id
location_id
id
changed_at
remote_deleted_at

Staffing Entity <> Legal Entity

Field	Notes
staffing_entity_id
legal_entity_id
id
changed_at
remote_deleted_at

Staffing entity <> Group

Field	Notes
staffing_entity_id
group_id
id
changed_at
remote_deleted_at

Feature	Notes
API Passthrough
Scope Testing
Per Model Tests
Custom Field Explorer
Employees
Employments
Staffing entities
Connection Guide
Create credentials
Employment History
Group Types
TEAM
DEPARTMENT

The behavior of this action depends on your UKG Pro configuration. If you selected UKG Onboarding during setup, it creates a “New Hire” that needs to be onboarded. If you selected UKG Pro, it creates an employee directly through the Import Tool.

International Import Tool hires are supported only when staffing_entity_id is provided and resolves to a country other than the USA or Canada. Without that context, Kombo returns the existing US hire form and requires an SSN.

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

import-tool
onboarding

Some optional form fields are referencing the following data models:

Employees

Consider enabling these in your scope configuration.

Form-specific constraints

Creates an employee directly in UKG Pro using the Import Tool API
International hires use the Global Hire transaction only when staffing_entity_id is provided and resolves to a country other than the USA or Canada. Without that context, the form uses the US Hire transaction and requires an SSN.

object

required

Key Fields

Show properties

single_select

required

Company
Unified field: legal_entity_id

date

Effective Date

object

required

Personal Information

Show properties

text

required

First Name
Unified field: first_name

text

required

Last Name
Unified field: last_name

text

Middle Name

text

Preferred Name

text

Former Name

single_select

Name Prefix

single_select

Name Suffix

single_select

required

Gender
Unified field: gender

date

required

Date of Birth
Unified field: date_of_birth

single_select

Marital Status

text

Home Phone

text

Business Phone

text

Business Phone Extension

text

Other Phone

text

Other Phone Type

text

Email Address
Unified field: private_email

text

Alternate Email

text

Mail Stop

text

Preferred Language For Pay Statement

text

Ethnic ID

text

single_select

Is Aboriginal

single_select

Is Visible Minority

object

required

Primary Address

Show properties

text

required

Address Line 1
Unified field: home_address.street_1

text

Address Line 2
Unified field: home_address.street_2

text

required

City
Unified field: home_address.city

text

required

State/Province
Unified field: home_address.state

text

Country
Unified field: home_address.country

text

required

Zip/Postal Code
Unified field: home_address.zip_code

object

required

Status Information

Show properties

date

required

Date of Last Hire
Unified field: start_date

date

Date of Original Hire

date

Date of Seniority

date

Date of Benefit Seniority

object

required

Job Information

Show properties

single_select

required

Job Code

single_select

required

Location Code
Unified field: location_id

single_select

required

Pay Group

single_select

Pay Scale Code

single_select

required

Employee Type

single_select

required

Full or Part Time

single_select

required

Salary or Hourly

number

Hourly Pay Rate

number

Annual Salary
Unified field: yearly_salary

number

required

Scheduled Work Hours

single_select

Supervisor ID
References /v1/hris/employees?remote_model=employee

single_select

required

Earnings Group Code

single_select

required

Benefit Group Code

single_select

Job Group

single_select

Pay Automatically

single_select

Org Level 1 Code

single_select

Org Level 2 Code

single_select

Org Level 3 Code

object

US Taxes

Show properties

text

Federal Filing Status Code

number

Federal Total Allowances

number

Federal Additional Amount Withheld

number

Federal Deduction Amount

single_select

Federal Employee Claims Exemption

number

Tax - Federal Other Income (US)

number

Tax - Federal Claim Dependents (US)

single_select

State Unemployment Tax Plan

text

Work In Filing Status Code

number

Work In Total Allowances Claimed

number

Work In Deduction Amount

single_select

Work In Employee Claims Exemption

number

Work In Additional Amount Withheld

object

required

Identification

Show properties

text

required

Social Security Number

text

Employee Number

text

National ID

object

Private Information

Show properties

text

Birth Country Code
Unified field: nationality

text

Birth Location

text

Disability Type

single_select

Is Veteran

single_select

Is Disabled

single_select

Military Branch Code

single_select

Military Era Code

single_select

Is Disabled Veteran

single_select

Is Medal Veteran

date

Military Separation Date

single_select

Is Active Wartime Veteran

date

National ID Expiration Date

text

Primary Nationality Code
Unified field: nationality

text

Secondary Nationality Code

text

Tertiary Nationality Code

single_select

text

Work Permit Country

text

Work Permit Reference ID

date

Work Permit Application Date

date

Work Permit Approval Date

date

Work Permit Expiration Date

single_select

Is Pensioner

text

I9 Visa Type

date

I9 Expiration Date

object

I-9 Employment Eligibility

Show properties

text

I9 Verified Code

text

I9 Document Number

date

I9 Expiration Date

text

I9 Document A Code

text

I9 Document B Code

text

I9 Document C Code

text

I9 Work Authorization

object

Direct Deposit Information

Show properties

text

required

Account Number

single_select

Account Is Inactive

number

Amount or Percentage

single_select

Account Type

text

required

Routing Number

text

Bank Name

single_select

required

Deposit Rule

text

Institution Number

single_select

Is Pre-Note

object

Emergency Contacts & Dependents

Show properties

object

Contact Information

Show properties

text

required

First Name

text

required

Last Name

text

Middle Name

text

Former Name

single_select

Name Suffix

single_select

required

Relationship Code

date

Date of Birth

single_select

Gender

text

SSN

text

National ID

single_select

Is Emergency Contact

single_select

Is Dependent

single_select

Is Beneficiary

checkbox

Is Active

single_select

Home Phone Country Code

text

Home Phone

text

Work Phone

single_select

Work Phone Country Code

text

Work Phone Extension

single_select

Preferred Phone

text

Email

single_select

required

Has Different Address

text

Address Line 1

text

Address Line 2

text

City

text

State/Province

text

Country

text

Zip/Postal Code

Some optional form fields are referencing the following data models:

Employees
Legal Entities

Consider enabling these in your scope configuration.

Form-specific constraints

Creates a new hire in UKG Onboarding that will go through the onboarding process

object

required

Contact Information
Contact information for the new hire

Show properties

object

required

Name
The name of the new hire

Show properties

text

required

First Name
The first name of the new hire
Unified field: first_name

text

Middle Name
The middle name of the new hire

text

required

Last Name
The last name of the new hire
Unified field: last_name

text

Former Last Name
The former last name of the new hire

text

Preferred First Name
The preferred first name of the new hire

text

required

Email Address
The email address of the new hire
Unified field: private_email

text

required

Primary Phone
The primary phone number of the new hire
Unified field: mobile_phone_number

text

Secondary Phone
The secondary phone number of the new hire

object

Address
The address of the new hire

Show properties

text

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

text

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

text

City
The city of the new hire
Unified field: home_address.city

text

Postal Code
The postal code of the new hire
Unified field: home_address.zip_code

text

State Code
The state code of the new hire
Unified field: home_address.state

text

Country
The country of the new hire
Unified field: home_address.country

single_select

Country Code
ISO country code of the address

object

Job
The job information for the new hire

Show properties

single_select

Job Code
UKG Pro job code
Unified field: job_title

text

Requisition ID
RequisitionId of the job

single_select

Component Company
Component company of the job
Unified field: legal_entity_id
References /v1/hris/legal-entities?remote_model=legal_entity

single_select

Work Location
Work location of the job
Unified field: location_id

single_select

Supervisor
Supervisor of the job
References /v1/hris/employees?remote_model=employee

single_select

Employee Type
Employee type for the job

single_select

Selected FLSA Status
Selected FLSA status for the job.

object

Organization Levels
Organization levels for the new hire

Show properties

single_select

Organization Level 1
Organization level 1 code

single_select

Organization Level 2
Organization level 2 code

single_select

Organization Level 3
Organization level 3 code

object

Compensation
Compensation information for the new hire

Show properties

checkbox

Is Full Time
Whether the new hire is full time

checkbox

Is Salaried
Whether the new hire is salaried

number

Work Hours
Work hours of the new hire

number

Weekly Hours
Weekly hours of the new hire. Only applicable for hires not in US/Canadian companies

text

Currency Code
ISO currency code of the new hire

number

Pay Rate
Pay rate of the new hire

single_select

Rate Per
Pay period of the new hire.

text

Onboarding Owner ID
External user identifier of the onboarding owner

text

Reference ID
Customer-provided identifier to track the new hire against their own system

date

Hire Date
Hire date of the new hire

date

Orientation Date
Orientation date of the new hire

date

Start Date
Start date of the new hire
Unified field: start_date

text

Past Start Date Reason
Reason why the new hire start date is 4 or more business days in the past

object

Mentor
Mentor for the new hire

Show properties

single_select

Mentor
Person from UKG Pro
References /v1/hris/employees?remote_model=employee

text

Mentor Description
Brief description of mentor

text

Personal Message
Personal message for the new hire

Integration Variants

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

UKG Pro ATS

UKG Pro for the ATS category

UKG Pro Assessment

UKG Pro for the Assessment category

General

Features

Guides

HRIS API Reference

Payroll API Reference

General API Reference

DATEV

UKG Pro HRIS Integration

Guides and Resources

Connection Setup Guide

Supported Features & Coverage

Integration Variants

UKG Pro ATS

UKG Pro Assessment

​Guides and Resources

Connection Setup Guide

​Supported Features & Coverage

​Integration Variants

UKG Pro ATS

UKG Pro Assessment

Guides and Resources

Supported Features & Coverage

Integration Variants