|Available for||User Roles||Super Admins, Admins, Team Members, Limited Team Members|
This help-article will walk you through the field mapping for the Lever-ADP Workforce Now integration. For an overview of the integration, please see How do I enable and use the ADP Workforce Now Integration.
Lever’s ADP Workforce Now integration allows you to streamline operations by automatically pushing new applicant onboard records to ADP when candidates are hired in Lever. Available information from Lever’s candidate profile, requisition, offer, and profile form are pre-populated in ADP’s New Hire Wizard, and therefore saves time and improves data entry quality. The field mapping can be done during or after enabling and setting up the Lever-ADP integration.
Lever-ADP Field Mapping Chart
The following field mapping chart outlines the fields used by the Lever-ADP Workforce Now integration.
Additional fields can be passed from Lever to ADP Workforce Now for pre-population by setting up an “ADP Integration Form” profile form and/or by adding custom fields to the Requisition object in Lever. Please make sure that the fields configured in Lever match the data type and values configured as listed in the chart below. Please note, configuring your profile forms and/or requisition custom fields is a one-time setup.
Lever Profile Forms
Configuring the field below is completely optional. If you would like to pass any of these fields from Lever to ADP, you'll need to set up a profile form called “ADP Integration Form”.
|Reason for Hire||dropdown||Reason for Hire||dropdown|
|First Name||text||First Name||string|
|Middle Name||text||Middle Name||string|
|Last Name||text||Last Name||string|
|Generation Suffix||dropdown||Generation Suffix||dropdown|
|Professional Suffix||dropdown||Professional Suffix||dropdown|
|Preferred Name||text||Preferred Name||text|
|Address Line 1||text||Address Line 1||string|
|Address Line 2||text||Address Line 2||string|
|Address Line 3||text||Address Line 3||string|
|Zip Code||text||Postal Code||string|
Configuring the field below is completely optional. Please note, the Lever Requisition Custom Field API name, must match exactly.
|Lever Field||Lever Field Id||Lever Data Type||ADP Field||ADP Data Type|
|ADP Job Code*||adpjobcode||dropdown||Job Title||dropdown|
|ADP Employee Type||adpemployeetype||dropdown||Worker Category||dropdown|
|ADP Business Unit||adpbusinessunit||dropdown||Business Unit||dropdown|
|ADP Department||adpdepartment||dropdown||Home Department||dropdown|
|Type of earnings||dropdown||Regular Pay Rate||dropdown|
|Offered compensation amount||text (single line)||Offered compensation amount||decimal|
|Compensation currency||dropdown||Compensation currency||dropdown|
Setting Up Profile Forms
This optional step needs to be done by a Lever Admin or Super Admin.
- Navigate to the form settings page in Lever Hire
- Add a new form titled “ADP Integration Form”
- Include all the fields that you would like to send to ADP
- Add the form to the desired candidate profile and fill out the form
Learn about setting up a profile form and adding it to the candidate profiles in this help article.
For example, if you want to pass ‘gender’ and ‘salutation’ fields, you would do so by following the above steps and as shown in the screenshot below:
Adding Custom Fields to Requisition
This step is also optional and needs to be configured by a Lever Admin or Super Admin.
- Navigate to the requisitions settings page, under the custom fields section in Lever Hire
- Add the custom requisition fields (from the chart below) that you would like to send to ADP
Learn more about requisitions in Lever in these help articles.
For example, if you want to pass the ‘ADP Employment Type’ field, you would do so by following the above steps and as shown in the screenshot below:
Passing ADP Dropdown Fields
For any field of type “dropdown” in ADP, the dropdown values in ADP must match the dropdown values configured in Lever. The Lever-ADP Integration can accept ADP dropdown values in three forms:
- Value Description
- Code Value
- Short Name
For example, if you want to add dropdown value for the ADP Job Code field, which maps to a custom requisition field in Lever, the dropdown values can be passed in any combination of the following ways:
- Value Description: DA - Data Analyst
- Code Value: DA
- Short Name: Data Analyst
In the screenshot below, notice the 3 values been passed in different 3 ways: