UKG Pro HRIS Integration

This connector is in open beta. You can freely enable it in your account.

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
remote_data

Work Locations

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
address
remote_data

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
remote_data

Absence Types

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
unit
remote_data

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
remote_data
custom_fields
integration_fields

Groups

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
type
remote_data

Time Off Balances

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

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
remote_data

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

Input Field	Notes
properties

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

The behavior of this action depends on your UKG Pro configuration. If you selected UKG Onboarding during setup, it will create a “New Hire” that needs to be onboarded. If you selected UKG Pro, it will create an employee directly in the system. For this option, you can only create employees for US Companies. If you need to create them for Canadian or Global companies, please contact support

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

KeyFields

object

required

Key Fields

Show properties

CompanyCode

single_select

required

Company
Unified field: legal_entity_id

EffectiveDate

date

Effective Date

Personal

object

required

Personal Information

Show properties

NameFirst

text

required

First Name
Unified field: first_name

NameLast

text

required

Last Name
Unified field: last_name

NameMiddle

text

Middle Name

NamePreferred

text

Preferred Name

NameFormer

text

Former Name

NamePrefixCode

single_select

Name Prefix

NameSuffixCode

single_select

Name Suffix

GenderCode

single_select

required

Gender
Unified field: gender

DateOfBirth

date

required

Date of Birth
Unified field: date_of_birth

MaritalStatusCode

single_select

Marital Status

PhoneHomeNumber

text

Home Phone

PhoneBusinessNumber

text

Business Phone

PhoneBusinessExtension

text

Business Phone Extension

PhoneOtherNumber

text

Other Phone

PhoneOtherTypeCode

text

Other Phone Type

AddressEmail

text

Email Address
Unified field: private_email

AlternateEmail

text

Alternate Email

MailStop

text

Mail Stop

PreferredLanguageForPayStatement

text

Preferred Language For Pay Statement

EthnicId

text

Ethnic ID

Ethnicity

text

IsAboriginal

single_select

Is Aboriginal

IsVisibleMinority

single_select

Is Visible Minority

PrimaryAddress

object

required

Primary Address

Show properties

AddressLine1

text

Address Line 1
Unified field: home_address.street_1

AddressLine2

text

Address Line 2
Unified field: home_address.street_2

AddressCity

text

City
Unified field: home_address.city

AddressStateCode

text

required

State/Province
Unified field: home_address.state

AddressCountryCode

text

Country
Unified field: home_address.country

AddressZipCode

text

Zip/Postal Code
Unified field: home_address.zip_code

Status

object

required

Status Information

Show properties

DateOfLastHire

date

required

Date of Last Hire
Unified field: start_date

DateOfOriginalHire

date

Date of Original Hire

DateOfSeniority

date

Date of Seniority

DateOfBenefitSeniority

date

Date of Benefit Seniority

JobInformation

object

required

Job Information

Show properties

JobCode

single_select

required

Job Code

LocationCode

single_select

required

Location Code
Unified field: location_id

PayGroup

single_select

required

Pay Group

PayScaleCode

single_select

Pay Scale Code

EmployeeTypeCode

single_select

required

Employee Type

FullOrPartTimeCode

single_select

required

Full or Part Time

SalaryOrHourly

single_select

required

Salary or Hourly

HourlyPayRate

number

Hourly Pay Rate

AnnualSalary

number

Annual Salary
Unified field: yearly_salary

ScheduledWorkHours

number

required

Scheduled Work Hours

SupervisorId

single_select

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

EarningsGroupCode

single_select

required

Earnings Group Code

BenefitGroupCode

single_select

required

Benefit Group Code

JobGrpCode

single_select

Job Group

IsAutopaid

single_select

Pay Automatically

OrgLevel1Code

single_select

Org Level 1 Code

OrgLevel2Code

single_select

Org Level 2 Code

OrgLevel3Code

single_select

Org Level 3 Code

USTaxes

object

US Taxes

Show properties

FederalFilingStatusCode

text

Federal Filing Status Code

FederalTotalAllowances

number

Federal Total Allowances

FederalAdditionalAmountWithheld

number

Federal Additional Amount Withheld

FederalDeductionAmount

number

Federal Deduction Amount

FederalEmployeeClaimsExemption

single_select

Federal Employee Claims Exemption

WorkInStateTaxPlan

single_select

State Unemployment Tax Plan

WorkInFilingStatusCode

text

Work In Filing Status Code

WorkInTotalAllowancesClaimed

number

Work In Total Allowances Claimed

WorkInDeductionAmount

number

Work In Deduction Amount

WorkInEmployeeClaimsExemption

single_select

Work In Employee Claims Exemption

WorkInAdditionalAmountWithheld

number

Work In Additional Amount Withheld

object

required

Identification

Show properties

SSN

text

required

Social Security Number

EmployeeNumber

text

Employee Number

NationalID

text

National ID

PrivateInfo

object

Private Information

Show properties

BirthCountryCode

text

Birth Country Code
Unified field: nationality

BirthLocation

text

Birth Location

DisabilityType

text

Disability Type

IsVeteran

single_select

Is Veteran

IsDisabled

single_select

Is Disabled

MilitaryBranchCode

single_select

Military Branch Code

MilitaryEraCode

single_select

Military Era Code

MilitaryIsDisabledVet

single_select

Is Disabled Veteran

MilitaryIsMedalVet

single_select

Is Medal Veteran

MilitarySeparationDate

date

Military Separation Date

MilitaryIsActiveWartimeVet

single_select

Is Active Wartime Veteran

NationalIDExpireDate

date

National ID Expiration Date

Nationality1Code

text

Primary Nationality Code
Unified field: nationality

Nationality2Code

text

Secondary Nationality Code

Nationality3Code

text

Tertiary Nationality Code

Smoker

single_select

WorkPermitCountry

text

Work Permit Country

WorkPermitRefID

text

Work Permit Reference ID

WorkPermitApplicationDate

date

Work Permit Application Date

WorkPermitApprovalDate

date

Work Permit Approval Date

WorkPermitExpirationDate

date

Work Permit Expiration Date

IsPensioner

single_select

Is Pensioner

I9VisaType

text

I9 Visa Type

I9ExpirationDate

date

I9 Expiration Date

object

I-9 Employment Eligibility

Show properties

I9VerifiedCode

text

I9 Verified Code

I9DocumentNumber

text

I9 Document Number

I9ExpirationDate

date

I9 Expiration Date

I9DocACode

text

I9 Document A Code

I9DocBCode

text

I9 Document B Code

I9DocCCode

text

I9 Document C Code

I9WorkAuthorization

text

I9 Work Authorization

DirectDeposit

object

Direct Deposit Information

Show properties

DDAccountNumber

text

required

Account Number

DDAccountIsInactive

single_select

Account Is Inactive

DDAmountOrPercentage

number

Amount or Percentage

DDAccountTypeCode

single_select

Account Type

DDRoutingNumber

text

required

Routing Number

DDBankName

text

Bank Name

DDDepositRuleCode

single_select

required

Deposit Rule

DDInstitutionNo

text

Institution Number

DDIsPreNote

single_select

Is Pre-Note

Contacts

object

Emergency Contacts & Dependents

Show properties

ContactDetail

object

Contact Information

Show properties

ConNameFirst

text

required

First Name

ConNameLast

text

required

Last Name

ConNameMiddle

text

Middle Name

ConNameFormer

text

Former Name

ConNameSuffixCode

single_select

Name Suffix

ConRelationshipCode

single_select

required

Relationship Code

ConDateOfBirth

date

Date of Birth

ConGender

single_select

Gender

ConSSN

text

SSN

ConNationalID

text

National ID

ConIsEmergencyContact

single_select

Is Emergency Contact

ConIsDependent

single_select

Is Dependent

ConIsBeneficiary

single_select

Is Beneficiary

ConIsActive

checkbox

Is Active

ConPhoneHomeNumberCountryCode

single_select

Home Phone Country Code

ConPhoneHomeNumber

text

Home Phone

ConPhoneWorkNumber

text

Work Phone

ConPhoneWorkNumberCountryCode

single_select

Work Phone Country Code

ConPhoneWorkExtension

text

Work Phone Extension

ConPhonePreferred

single_select

Preferred Phone

ConEmail

text

Email

ConIsDifferentAddress

single_select

required

Has Different Address

ConAddressLine1

text

Address Line 1

ConAddressLine2

text

Address Line 2

ConAddressCity

text

City

ConAddressStateCode

text

State/Province

ConAddressCountryCode

text

Country

ConAddressZipCode

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

contactInformation

object

required

Contact Information
Contact information for the new hire

Show properties

name

object

required

Name
The name of the new hire

Show properties

first

text

required

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

middle

text

Middle Name
The middle name of the new hire

last

text

required

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

formerLast

text

Former Last Name
The former last name of the new hire

preferredFirst

text

Preferred First Name
The preferred first name of the new hire

emailAddress

text

required

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

primaryPhone

text

required

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

secondaryPhone

text

Secondary Phone
The secondary phone number of the new hire

address

object

Address
The address of the new hire

Show properties

line1

text

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

line2

text

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

city

text

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

postalCode

text

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

stateCode

text

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

country

text

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

countryCode

single_select

Country Code
ISO country code of the address

job

object

Job
The job information for the new hire

Show properties

code

single_select

Job Code
UKG Pro job code
Unified field: job_title

requisitionId

text

Requisition ID
RequisitionId of the job

componentCompany

single_select

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

workLocation

single_select

Work Location
Work location of the job
Unified field: location_id

supervisor

single_select

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

employeeType

single_select

Employee Type
Employee type for the job

selectedFLSAStatus

single_select

Selected FLSA Status
Selected FLSA status for the job.

organizationLevels

object

Organization Levels
Organization levels for the new hire

Show properties

orgLevel1Code

single_select

Organization Level 1
Organization level 1 code

orgLevel2Code

single_select

Organization Level 2
Organization level 2 code

orgLevel3Code

single_select

Organization Level 3
Organization level 3 code

compensation

object

Compensation
Compensation information for the new hire

Show properties

isFullTime

checkbox

Is Full Time
Whether the new hire is full time

isSalaried

checkbox

Is Salaried
Whether the new hire is salaried

workHours

number

Work Hours
Work hours of the new hire

weeklyHours

number

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

currencyCode

text

Currency Code
ISO currency code of the new hire

payRate

number

Pay Rate
Pay rate of the new hire

ratePer

single_select

Rate Per
Pay period of the new hire.

onboardingOwnerId

text

Onboarding Owner ID
External user identifier of the onboarding owner

referenceId

text

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

hireDate

date

Hire Date
Hire date of the new hire

orientationDate

date

Orientation Date
Orientation date of the new hire

startDate

date

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

pastStartDateReason

text

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

mentor

object

Mentor
Mentor for the new hire

Show properties

code

single_select

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

description

text

Mentor Description
Brief description of mentor

personalMessage

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

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

General

Features

Guides

HRIS API Reference

General API Reference

DATEV

Documentation Index

​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