| Available for | Roles | Super Admin, Admin |
| Permissions | • (To use) Manage profiles and view associated permissions • (To enable) Manage API credentials and manage integrations |
|
| Packages | LeverTRM, LeverTRM for Enterprise |
Lever’s ADP Workforce Now integration allows you to streamline operations by automatically pushing new applicant onboarding 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, saving time for your team and improving data quality. The field mapping can be done during or after enabling and setting up the Lever-ADP integration.
|
|
This integration requires purchasing a connector in the ADP Marketplace. Note that Lever's integration only supports the United States ADP Marketplace. In addition, this integration cannot be used with ADP's Next Gen product. If you are using ADP Next Gen, the required connector will not be available for purchase in the ADP Marketplace (see the setup article linked above for more information). |
Lever-ADP Field Mapping
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. Also note that configuring your profile forms and/or requisition custom fields is a one-time setup.
Lever Candidate
| Lever Field | Lever Data Type | ADP Field | ADP Data Type |
| Name | text | First Name | string |
| Name | text | Middle Name | string |
| Name | text | Last Name | string |
| text | Home Email | string | |
| Phone | text | Personal Cell | integer |
Lever Profile Forms
Configuring the fields listed below is optional. If you would like to pass any of these fields from Lever to ADP, you will need to set up a profile form titled 'ADP Integration Form.'
| Reason for Hire | dropdown | Reason for Hire | dropdown |
| Salutation | dropdown | Salutation | 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 |
| Gender | dropdown | Gender | dropdown |
| Address Line 1 | text | Address Line 1 | string |
| Address Line 2 | text | Address Line 2 | string |
| Address Line 3 | text | Address Line 3 | string |
| City | text | City | string |
| State | dropdown | State/ Territory | dropdown |
| Zip Code | text | Postal Code | string |
| Country Code | dropdown | Country | dropdown |
Lever Requisition
|
|
Custom requisition fields are optional and require either an Enterprise plan or the Custom Requisition Fields add-on. Please reach out to your Lever account representative if you would like to add custom requisition fields to your Lever Hire account. |
| Lever Field | Lever Field Id | Lever Data Type | ADP Field | ADP Data Type |
| ADP Job Code | adpjobcode | dropdown or text | 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 |
Lever Offer
| Type of earnings | dropdown | Regular Pay Rate | dropdown |
| Offered compensation amount | text (single line) | Offered compensation amount | decimal |
| Compensation currency | dropdown | Compensation currency | dropdown |
| Office location | text (single line) | Location | dropdown |
Lever Webhook
| - | datetime | Hire Date | date |
Setting up profile forms
|
|
This optional step can only be completed in Lever by a user with Admin or Super Admin level access. |
- Navigate to Settings > Forms
- 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
Refer to our article on Forms to learn how to set up a profile form and add it to a candidate profile.
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 a requisition
|
|
This optional step can only be completed in Lever by a user with Admin or Super Admin level access. |
- Navigate to Settings > Requisitions
- Add the custom requisition fields (from the chart below) that you would like to send to ADP
Refer to our Requisitions help article to learn more about set-up and manage requisitions.
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 how the three values have been passed in three different ways:
