UKG Pro Integration Overview

Last updated: November 2, 2026

UKG Pro is UKG's enterprise HR, payroll, and workforce management platform. Connecting it through Onboarded means a new hire's onboarding data flows straight into UKG Pro, ready for payroll to review, without anyone retyping a single field by hand.

At a glance

Sync direction: Onboarded to UKG Pro
Setup: credentials and configuration, no custom build required
Coverage: 116 fields across 7 data categories

Why connect it through Onboarded

Manual re-entry between onboarding and payroll is where errors slip in: a wrong account number, a mismatched filing status, a stale code. Connecting UKG Pro removes that handoff entirely.

Eliminate double entry. New-hire data collected once during onboarding flows straight into UKG Pro.
Cut payroll errors at the source. Tax withholding and direct deposit are pulled automatically instead of re-keyed by hand.
Get new hires submission-ready before day one. A record is compiled and ready for payroll the moment onboarding wraps up.

Integration features

Onboarded compiles a new hire's onboarding data, employee info, job info, tax withholding, direct deposit, and accruals, into a submission-ready UKG Pro record.

Live reference-data sync. UKG Pro's own location, job, and pay group codes stay current.
Field-level error handling. A rejected submission flags the exact field that caused it.
Address lines that fit. UKG Pro takes up to 30 characters per address line. Onboarded shortens longer lines with standard USPS abbreviations, and the address stored in Onboarded doesn't change. If a line is still too long, the submission stops and asks for a shorter address.
Automatic rehire detection. Existing employee records are matched before a new one is created.
Configurable per customer. Every field can be enabled, required, assigned, defaulted, or source-mapped out of the box.

Fields by category

Category	Fields	Required
Employee Info	36	12
Job Information	32	10
Work State Withholding	16	1
Resident State Withholding	12	1
Federal Withholding (W-4)	9	1
Direct Deposits	8	1
Accruals	3	0

Employee Info

36 fields, 12 required

Field	Required
Address line 1	Yes
Address line 2
Alternate email address
Benefit seniority date
Birth date	Yes
Address city	Yes
Company identifier	Yes
Country	Yes
Address county
Primary email address
Employee number
Ethnic origin code
First name	Yes
Former last name
Gender	Yes
Date of hire	Yes
Home phone
Last name	Yes
Mail stop
Marital status code
Middle name
Date of next performance review
Date of next salary review
Other phone type
Other phone number
Other phone extension
Preferred first name
Prefix name code
Date of seniority
Social Security number	Yes
State or province code	Yes
Suffix name code
Work phone extension
Work phone
ZIP / postal code	Yes
Distribution center

Job Information

32 fields, 10 required

Field	Required
Alternate job title
Deduction / benefit group code	Yes
Earnings group code	Yes
Employee type code	Yes
Full or part time	Yes
Hire source code
Hourly or salaried	Yes
Job code	Yes
Job group code
Location code	Yes
Organizational 1 code
Organizational 2 code
Organizational 3 code
Organizational 4 code
Other rate 1
Other rate 2
Other rate 3
Other rate 4
Pay automatically
Pay group code	Yes
Pay rate	Yes
Project code
Scheduled hours	Yes
Shift code
Shift group code
Supervisor
Time clock
Pay scale code
Step number
Local union code
National union code
Override company level rate

Work State Withholding

16 fields, 1 required

Field	Required
Local work-in tax resident status
State geographic code
State occupational code
Work state adopted dependent exemptions
Work state deduction amount
Work state dependent amount
Work state other income
Work state additional allowances
Work state additional amount withheld
Work state disability plan type
Work state employee claims exempt
Work state filing status code	Yes
Work state plan code
Work state total allowances (count)
Work state total allowances claimed, dollar amount (Iowa only)
VT child care contribution employee tax rate

Resident State Withholding

12 fields, 1 required

Field	Required
Resident state adopted dependent exemptions
Resident state deduction amount
Resident state dependent amount
Resident state other income
Resident state additional allowances
Resident state additional amount withheld
Resident state employee claims exempt
Resident state filing status code	Yes
Resident state total allowances claimed (state live-in)
Resident state total allowances claimed, dollar amount (Iowa only)
Resident county code
Resident jurisdiction

Federal Withholding (W-4)

9 fields, 1 required

Field	Required
Federal additional amount withheld
Federal deduction amount
Federal dependent amount
Federal employee claims exempt
Federal filing status code	Yes
Federal other income
Federal subject to backup withholding
Total federal allowances claimed
Federal W-2 pension

Direct Deposits

8 fields, 1 required. Repeatable, an employee can have multiple accounts.

Field	Required
Direct deposit records
Account is active
Account number
Account type	Yes
Amount rule
Bank name
Flat or percent amount
Routing number

Accruals

3 fields, none required

Field	Required
PTO plan code
Current PTO balance available
Earned-through date