| Available for | Roles | Super Admin, Admin, Team Member, Limited Team Member Can only be enabled by Super Admins |
| Permissions | • (To use) Manage profiles and view associated postings • (To enable) Mange API credentials and manage integrations • (To access requisition fields) Manage requisition settings |
|
| Packages | LeverTRM for Enterprise, Advanced HR add-on |
This article provides a breakdown of how fields are mapped between Lever and UKG Pro Onboarding (formerly known as UltiPro Onboarding) when new hire data is transferred. Before proceeding, we recommend reading our help article on how to set up and use the UKG integration. Also note that the UKG integration requires a Lever package that includes requisition management (applicable packages are listed at the top of this article).
Opportunity profile field mapping
Here is a breakdown of how fields are passed from the opportunity profile in Lever to the new hire record in the UKG Pro Onboarding module:
| Lever Field | UKG Field | Notes |
| Name | First Name† | Full name is split by a space, and then the first value is returned and captured. |
| Name | Last Name† | Full name is split by a space, and then the last value is returned and captured. |
| Email† | If more than one email is listed in Lever, the top-listed email will be passed. | |
| Phone | Primary Phone | Mobile phone number is extracted first. If no mobile phone number is present, the top-listed phone number is passed. |
| Phone | Secondary Phone | Home phone number is extracted first. If no home phone number is present, the phone number following the mobile or top-listed listed phone number is passed. The Primary Phone value will not be duplicated. |
| †Required value | ||
In the image below, you can see where these fields are located on the opportunity profile in Lever.
Requisition field mapping
The UKG integration will automatically create the following custom requisition fields in your Lever environment:
- UKG Pro Onboarding Owner
- UKG Pro Component Company Code
- UKG Pro Job Code
- UKG Pro Employee Type
- UKG Pro Work Location
- UKG Pro <ORG 1 NAME>
- UKG Pro <ORG 2 NAME>
- UKG Pro <ORG 3 NAME>
- UKG Pro <ORG 4 NAME>
In the image below, you can see where the custom fields are located in your Requisition settings:
Not only will the integration generate these custom fields, it will also manage the drop-down options for each field, syncing values directly from your UKG environment on a daily basis. For more details on the setup process, refer to our help article on setting up and using the UKG Pro Onboarding integration.
An example of drop-down options for a custom requisition field synced from UKG.
Here is a breakdown of how fields are passed from the requisition in Lever to the new hire record in the UKG Pro Onboarding module:
| Lever Field | UKG Field | Notes |
| UKG Pro Component Company Code | Component Company Code † | Code is parsed from dropdown value (e.g. “Eastwood Industries - HQ(005) | HDLBX” becomes “HDLBX”) |
| UKG Pro Job Code | Job Code† | Code is parsed from dropdown value (e.g. “Accountant | ACCOUNT” becomes “ACCOUNT”) |
| UKG Pro Onboarding Owner | Onboarding Owner Code† | ID is parsed from dropdown value (e.g. “Jeanne Foster | a0d3f080-fd69-4a46-8614-86202fd70dbf” becomes “a0d3f080-fd69-4a46-8614-86202fd70dbf”) |
| UKG Pro Employee Type | Employee Type Code | Code is parsed from dropdown value (e.g. “Regular | REG” becomes “REG”) |
| UKG Pro Work Location | Work Location Code | Code is parsed from dropdown value (e.g. “San Francisco, CA | SANF” becomes “SANF”) |
| UKG Pro <ORG 1 NAME> | Organization 1 Code | Code is parsed from dropdown value (e.g. “Software | SOFT” becomes “SOFT”) |
| UKG Pro <ORG 2 NAME> | Organization 2 Code |
Code is parsed from dropdown value (e.g. “Corporate | CORP” becomes “CORP”) |
| UKG Pro <ORG 3 NAME> | Organization 3 Code | Code is parsed from dropdown value (e.g. “West | WE” becomes “WE”) |
| UKG Pro <ORG 4 NAME> | Organization 4 Code | Code is parsed from dropdown value (e.g. “Isaacs, Victor | 02008” becomes “02008”) |
| Work Type | isFullTime | TRUE if solution locates “full time” or “full-time” in the Work Type value (case sensitivity is ignored) |
| †Required value | ||
In the image below, you can see where the fields are located on the requisition in Lever:
Profile form field mapping
Once the integration has been setup, a new profile form template titled "UKG Pro Onboarding New Hire Form" will be added to your Lever instance. This is an optional form that recruiters can fill out to provide more detailed name and address information about a candidate (beyond what is captured on the opportunity profile).
Here is a breakdown of how fields are passed from the profile form (if it has been filled out) in Lever to the new hire record in the UKG Pro Onboarding module:
| Lever Field | UKG Field | Notes |
| First Name | First Name † | If the profile form has not been filled out, the first name on the opportunity profile will be passed. |
| Preferred Name | Preferred Name | |
| Middle Name | Middle Name | |
| Last Name | Last Name† | If the profile form has not been filled out, the last name on the opportunity profile will be passed. |
| Prefix Code | Prefix Code | |
| Suffix Code | Suffix Code | |
| Address Line 1 | Address Line 1 | |
| Address Line 2 | Address Line 2 |
|
| City | City | |
| State | State | |
| Zip | Zip | |
| Country | Country | |
| Personal Message | Personal Message | |
| †Required value | ||
In the image below, you can see where the fields are located on the profile form in Lever:
Offer form field mapping
Here is a breakdown of how fields are passed from the offer form in Lever to the new hire record in the UKG Pro Onboarding module:
| Lever Field | UKG Field | Notes |
| Offered compensation amount | Pay Rate | |
| Type of earnings | Per Rate | |
| Type of earnings | Is Salaried | TRUE if Type of earnings is “Year (Salary)” or “Month (Salary)” |
| Anticipated Start Date | Start Date | |
| Anticipated Start Date | Hire Date | |
In the image below, you can see where the fields are located on the offer form in Lever:
Custom field mapping
If you capture new hire information in your Lever instance outside of the areas listed above and you would like that information passed to your UKG Pro Onboarding module, be sure to mention it on the setup form when setting up the integration. The Lever team can investigate the potential to adjust the mapping configuration to accommodate those fields. Note that UKG limits the ability to populate standard fields for an onboarding record and information cannot be passed from Lever to custom fields in UKG.