Skip to main content
The UKG Pro integration syncs employees from UKG Pro HCM into Pike members, with their org level, job, supervisor and scheduled hours, and syncs approved time off from UKG Pro Workforce Management into Pike time off. For hourly employees, Pike can send approved hours to their UKG Pro Workforce Management timecard as pay code edits. Capacity, utilization and payroll then use the same people and the same hours.

​
At a glance

​
Before you start

You need:
  • The workspace admin role in Pike.
  • A UKG Pro web service account. A UKG Pro admin creates it under System Configuration → Security → Web Service Accounts and gives it the View role for the Employee Person Details, Employee Employment Details, Compensation Details and Company Configuration Integration web services. The same page shows your Customer API Key and the service host for your data center.
  • For time off and hours, UKG Pro Workforce Management API credentials: the tenant hostname, an application key, a client ID and client secret, and an API user whose function access profile can view time off requests and edit timecards. Your UKG Pro Workforce Management admin creates these.
  • Pike time off types for the UKG Pro pay codes you use for time off. You map each one during setup. See Time off.

​
Connect UKG Pro

1

Open the integration

Go to Workspace settings → Integrations → UKG Pro and click Add integration.
2

Connect UKG Pro HCM

Enter the service host, the web service account user name and password, and the Customer API Key, then click Connect. Pike checks the account and shows your UKG Pro companies.
3

Connect Workforce Management

Under Workforce Management, enter the tenant hostname, application key, client ID, client secret, and the API user name and password, then click Connect.
4

Choose teams and time off types

Under Teams from, choose the org level that becomes Pike teams. Under Time off types, choose a Pike time off type for each UKG Pro time off pay code. Pike suggests a mapping from the pay code names.
5

Choose what syncs

In the What syncs with UKG Pro card, turn Read and Send on or off for each entity, and choose whether to turn on Invite new employees.
6

Import

Click Import data. Org levels import first, then employees, then time off.
The integration page shows Connected, the UKG Pro company name, Last synced and Next sync.

​
What syncs

​
Employees

To give a part-time employee a different weekday pattern, set the work schedule in Pike. Pike uses that schedule as long as the weekly total matches UKG Pro.

​
Time off

Default type mapping: vacation to Vacation, sick to Sick, parental to Parental, time off in lieu to Time off in lieu, unpaid to Unpaid leave, and every other pay code to Vacation. Each type counts toward the member’s norm hours as set on the Pike type.

​
Compensation

Sync compensation to cost profiles is off by default. Only admins and finance users can turn it on. See Cost profile.

​
Hours to Workforce Management

Send hours to payroll is off by default. When on, closing a pay period in Pike sends each hourly employee’s approved hours to their UKG Pro Workforce Management timecard as pay code edits, one per day and pay code. Under Pay codes, map normal hours to your regular pay code and paid-out Overtime 1 and Overtime 2 to your overtime pay codes. UKG Pro Payroll then picks up the hours from the signed-off timecard. Hours for salaried employees are not sent. Pike does not run payroll or calculate tax.

​
Matching and duplicates

On the first import, Pike matches before it creates:
  • An employee matches a Pike member with the same work email. A match links the two, and UKG Pro values replace the Pike values for the fields in the mapping.
  • An org level matches a Pike team with the same name. A job title matches a Pike position with the same name.
  • Time off always imports as new time off. Time off already entered in Pike for the same member and dates stays, and the UKG Pro request is listed in Sync issues as an overlap.
An employee with no matching member appears under Unmatched employees on the integration page. Click Invite to send a Pike invite, or Link to member to link the employee to a member with a different email. With Invite new employees on, Pike sends the invite automatically with the default role the admin chose.

​
Which system wins

Edit UKG Pro-owned fields in UKG Pro. Pike shows them as read-only with the UKG Pro marker.

​
Sync schedule

Pike syncs UKG Pro every 3 hours. On the Enterprise plan, changes sync in real time. Closing a pay period sends hours to UKG Pro straight away on every plan, as do Import data, Sync now and Refresh on a member. See How sync works.

​
Sync settings

While UKG Pro is connected, the What syncs with UKG Pro card is below the top button row on the integration page. Toggles save immediately. New connections start with Read on for employees, org levels and time off, with Invite new employees, compensation and Send hours to payroll off.

​
How it works

​
Use it in Pike

​
Plan around approved leave

Open Members → Allocations to see each person’s capacity for the week, set from their UKG Pro scheduled hours. Approved time off shows on the day with its type, and the hours are already removed from capacity, so an over-allocated day stands out before the work is due. See Workspace capacity.

​
Onboard a new hire

When a new hire is added in UKG Pro, they appear in Pike with their team, position and weekly capacity on the next sync. Turn on Invite new employees, or click Invite under Unmatched employees, and the person can log time on their first day.

​
Offboard a leaver

When an employee is terminated in UKG Pro, the member is deactivated in Pike. Their logged time, allocations and history stay on every project, and they stop counting toward capacity from the termination date.

​
Send hours for hourly employees

Approve time in Pike, then close the pay period. The pay period shows Sent to UKG Pro with the number of pay code edits. An employee whose timecard does not accept the edits appears in Sync issues with the reason.

​
Deletes and removed records

An integration never deletes Pike data. An employee removed from UKG Pro, or no longer visible to the web service account, is marked Removed in UKG Pro on the member, stays in Pike with their history, and stops syncing. A time off request canceled in UKG Pro after approval is removed from Pike capacity on the next sync, and the change appears in the member’s time off history. Pay code edits already sent stay on the timecard.

​
Troubleshooting

​
Limits

  • Pike does not create or change employees, org levels or time off requests in UKG Pro.
  • Pending, refused or canceled time off requests do not sync.
  • Hours go to UKG Pro only for hourly employees, only from closed pay periods, and only from approved time.
  • Time off and hours need UKG Pro Workforce Management. With only UKG Pro HCM connected, employees, org levels, scheduled hours and compensation sync.
  • Pike sends hours as pay code edits. It does not send punches.
  • Compensation sync is off until an admin or finance user turns it on.

​
Disconnect

Go to Workspace settings → Integrations → UKG Pro and click Disconnect. Syncing stops and every member, team, position and time off entry stays in Pike with its history. Reconnecting the same UKG Pro company relinks the members.