How do I setup the Lever and Refapp integration?

Setting up the Lever and Refapp integration to perform effortless reference checks from within Lever is easy and consists of just a few simple steps.

Enabling the integration

  1. Ensure you are logged in to Refapp as a Refapp Administrator.
  2. Go to the Company Settings page



3. Open the Integrations tab and locate the Lever logo. If you are running Lever in the EU data centre, you need first to select EU from the Data Centre list and click Save. Next, click Connect with Lever.

4. For the EU data centre, skip to the next section. Otherwise, continue below.

US Data Centre: OAuth flow


5. When connecting to a Lever account in the US data centre (, you will now be taken to Lever. After logging in, you are presented with an authorization confirmation question. Click Accept to continue and allow Refapp to read and write data in your Lever account.

6. You are now taken back to Refapp. Click Connect to finalise the connection and go back to the Company Settings page.

7. Skip over the next section (EU Data Centre).

EU Data Centre: API Key

8. (continued from step 4) You are now ready to enter an API key into Refapp. You create the API key in the next step (step 9). 

9. Open Lever in a different tab and create an API key for your Lever account. Check the following permission boxes:

Read endpoints: 

1. read user
2. read posting
3. read opportunity
4. list webhooks
5. list stages
6. list users

Write endpoints:

1. add opportunity tag
2. remove opportunity tag
3. create opportunity note
4. delete opportunity note
5. create opportunity
6. add webhooks


10. Paste the API key into the Refapp page and click Connect.

Configuration (both data centres).

11. In Refapp: Select the Lever recruitment stage that should trigger a reference check in Refapp.
Click Configure below the Lever logo, select the stage from the dropdown and click OK followed by Save in the bottom of the Company Settings page. If you don’t have a reference check stage, contact Lever support and they will assist you in getting one added.



12. Ensure that candidate stage change webhooks are enabled in Lever (this is disabled by default).

13. Now you are all set and anyone in your team can run Refapp reference checks from within Lever.


Working with Refapp reference checks in Lever

Any time a candidate reaches the Lever stage that was configured in the setup, the candidate is added to Refapp in a project that corresponds to the Lever Job Posting that the candidate is considered for.

To get the most value out of the integration, you need to work with Refapp project templates and select the appropriate template for the position via Lever Tags.

Here’s how it works:

Set up Refapp Project Templates
Start by adding project templates corresponding to your typical hiring types. This includes which questions to ask, automation options etc. More information can be found in this help centre article:

Whenever you have modified the list of templates (added, removed or renamed), you need to synchronise with Lever by opening Company Settings + Integrations + Lever Configure and clicking Update. This step ensures that the tags shown in Lever for settings correspond to your current project template list.

Select the setting (project template) via Lever Tags
In the settings when you set up or edit a Job in Lever, type an R in the Tags field and select from the tags starting with Refapp Template.


Now, when a candidate reaches the Reference Check stage (or whichever stage you configured to start the reference checking), the candidate is created in Refapp and both a Note and a Tag is added to the candidate in Lever to display the progress:


As the reference check proceeds and is finally completed, the note and tag (Refapp Status: XXX) for the candidate in Lever will update accordingly and you can easily jump into Refapp to view the report and/or the Refapp candidate page via links in the note:

Disabling the Refapp integration

  • Navigate to Settings > Integrations and API > Authorized Apps
  • Locate the Refapp app
  • Click Revoke Access

Important notes

  • The candidate language for candidates in Refapp will always be set to your account default language since there is no setting for language on candidate level in Lever, so ensure your project templates always include a questionnaire for the default language. If you need to change the language, you can edit the candidate language in Refapp at any time.
  • The project in Refapp will be accessible to both the Lever user that moved the candidate to the Reference Check stage and the Posting owner (shown in the Job Postings card). Users will be invited automatically to Refapp if they haven’t yet set up their account. The Hiring Manager (if other than the owner or stage changer) is not added to the Refapp project automatically.