Enabling and using the Namely integration

Available for User roles Super Admin, Admin, Team Member, Limited Team Member
Can only be configured by Super Admins
Packages All packages

As an official Namely partner, Lever makes it easy to automatically push hired candidate information from Lever into Namely, streamlining the recruiting to HR process and hence, saving time and improving data entry quality. Hired candidate data from Lever can be configured to push into Namely Onboarding or HRIS.

Process flow diagram from Lever to new hire data to namely


Please note: To enable this integration, you’ll need to be a Super Admin of your Lever account and an Administrator of your Namely account. If the Namely personal access token is generated by a user other than an Administrator, you may not see all candidate details from Lever pre-populated in your Namely instance.


First name Middle name Last name
Preferred name Mobile phone Home phone
Personal email Email LinkedIn URL
Job title Employee type Start date
Salary Currency Type* Salary Amount* Salary Start Date*

*At this time, Namely only accepts salary information for employees with annually defined salaries. This means that hourly employees, for example, will not have their salary information populated into their corresponding Namely profile.

Enabling the Namely Integration in Lever

First, navigate to your account's Integrations page in Settings

Lever settings integrations page with arrow pointing to namely in integrations list

 When you toggle on the Namely integration, please read through the accompanying integration details, then click the button "Send request to enable" which will notify Lever Technical Support of your request.

Lever settings namely section with send request to enable button outlined

Lever will reach out to you requesting the following required information:

  • Namely Company URL - Be sure this is an EXACT match with the spelling you use for your Namely account (e.g. https://:COMPANY.namely.com/)
  • Namely Personal Access Token - This key can be generated from your Namely dashboard (Details below)
  • Desired Namely Record Type - You have the opportunity to choose whether to create a new Namely HRIS record, or create a new Namely Onboarding record when candidates are hired in Lever.

Configuring Namely

Creating a Personal Access Token

Tip: We recommend that you create a non-user account in your Namely instance with full Admin access to create the API key (such as integration@yourcompany.com). This will assure that the integration continues to operate successfully in the event that your admin users depart or have access role changes. This can be configured within the Namely's Personal Access Tokens menu.

 To generate a personal access token, follow the steps below:

1. Login to Namely as the user account that you wish to use for the key creation

2. Click on your profile image in the top right corner of the window and select API.

Namely platform showing dropdown menu with API option outlined

3. Select the Personal Access Tokens tab in the API menu.

Namely platform with personal access tokens tab outlined

4. In the Name text field, type "Lever Integration" and select the Create button.

Namely platform showing personal access tokens tab with lever integration outlined

Once complete, Namely will generate a personal access token which you should copy and store in a document you can easily access. You will provide this token to Lever as part of your configuration.

Field Mapping

The Namely integration pulls candidate details from a variety of locations in Lever. Take some time to read through following help article which describes how the offer and profile forms can be configured to specify which data is sent to Namely.

Creating a new Namely record from Lever

Once the integration has been configured, you can begin sending new hire candidate data from Lever to Namely. The integration will create either an Onboarding record or a new HRIS record in Namely, depending on which you've selected for your integration.

Candidate Preparation

Before hiring the candidate, make sure that all desired fields are filled out on the candidate, requisition, offer and "Namely Form" profile form. The more fields present and populated in Lever, the more fields that will be pre-populated in Namely. 

Lever candidate profile showing filled fields

Namely-NamelyForm.pngNamely form in Lever with offer details

Hiring a Candidate

Once the candidate details have been filled out, you may then archive the candidate as "Hired" in Lever.

Lever candidate profile showing green hired banner

If you have elected to configure the Namely integration for Onboarding, a draft onboarding session will automatically be created in Namely within a few minutes. At a minimum, First Name, Last Name and Email are required to create a record in Namely.

Namely platform with candidate outlined

Notice that many profile fields and salary information are pre-populated in Namely. For more information, please refer to our help article how Namely fields get mapped

Namely platform showing candidate profile with custom fields outlined

Namely platform showing candidate profile showing salary information

From here your team may click on the candidate to continue finalizing the candidate details. Once complete, click the Kick Off button to finish.

Namely platform showing candidate onboarding form

If you have elected to configure the Namely integration for HRIS, the candidate will be created as a new employee directly in Namely HRIS.

Namely platform showing employee profile

Once the record has been successfully created in Namely, a new story will appear on the candidate profile page in Lever with the Namely ID.

Lever showing candidate profile with namely profile section outlined

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