Field mapping between Lever and ADP Workforce Now

Follow
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
Email 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.' 

Lever Field
Lever Data Type
ADP Field
ADP Data Type
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

Lever Field
Lever Data Type
ADP Field
ADP Data Type
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

Lever Field
Lever Data Type
ADP Field
ADP Data Type
- 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:

Lever Form editor with arrows pointing to the profile form title field (ADP Integration Form), field name (Gender), data type (Dropdown).

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:

Custom fields section of Requisitions Settings page with arrow pointing to add new field button.

Custom fields section of Requisitions Settings page with new field inputs expanded and arrows pointing to field name (ADP Employee Type), Field id (adpemployeetype) and data type (dropdown).

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:

Dropdown values in Custom fields section of Requistions Settings page.

Was this article helpful?
3 out of 3 found this helpful