How do I enable and use the Suitable integration?

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

The Suitable integration will seamlessly sync referrals and job postings with Lever. Suitable makes it easier for recruiters to connect with potential talent from their employees social and professional networks.

Readers of this article will learn the following:


Setup the integration:


Access role must be Super Admin in Lever to set up the integration. You must be a team or organization with admin rights in Suitable to install this integration.

1. In Suitable, find the Preferences option in the menu on the top right side of your Suitable dashboard. 

2. Once the Preferences page is loaded, you should be able to see the Integrations tab on the left (this is only visible to workspace admins and recruiters with "Manage Integrations" permission).

3. Once the integrations tab is loaded, locate the Link Lever button in the third row of the list. Click Link Lever. 


4. On the modal, sign into Lever. 

Please review the requested permissions below: 

  • View all candidate's applications: Required to sync referrals from Lever to Suitable.
  • View and manage all opportunities: Required to post referrals to Lever from Suitable.
  • View all postings: Required to sync jobs from Lever to Suitable.
  • View all stages: Required to sync job pipeline stages from Lever to Suitable.
  • Manage all webhooks: Required to update referral status in realtime from Lever to Suitable.
  • Allow offline access: Required to sync from and to Lever and Suitable without re-login automatically.

5. After reviewing the requested permissions, click Accept.

For any questions, please reach out to

6. Once accepted, you will be redirected to Suitable and your integration will complete in the background.


Enable Webhooks

1. To enable webhooks, click here or go to Settings > Integrations & API > Webhooks.

2. Toggle the Candidate Stage Changed and Candidate Hired webhooks to the on position. 


How to use the integration:

Does the integration change making referrals via Suitable?

Nothing changes apart from the fact that all referrals to your jobs posted on Lever will get synced to Suitable almost instantly.

Let's try making a referral as an employee from your Suitable workspace.

Now let's see how it looks in your Lever dashboard:


How does the integration affect referral tracking for recruiters?

The integration allows your team to sync referrals seamlessly between Lever and Suitable. 

At this point, there is no progress to the referral. But after moving the referral to a different stage in Lever, it looks something like this in your Suitable workspace:

Moving even further in Lever to the Hired stage. 

Wasn't that a piece of cake? So easy.


Every midnight, Suitable will automatically resync all your data from Lever to your Suitable workspace in addition to force syncing data to Lever from your Suitable dashboard.


How do I manually sync postings and referrals? 

If you wish to sync postings and referrals to-and-from Lever and Suitable, from your Suitable dashboard, just click on the Sync with Lever button. 

Your recruiters and employees will be able to see the same button in their respective referral tracking pages. 

In case you have any questions relating to the Suitable integration, please reach out or use the chatbox located at the bottom of the Suitable platform. 


How to disable the integration:

1. Navigate to your Integrations & API Settings Page in Lever.

2. Under the Authorized Apps tab, locate the Suitable app.

3. Click Revoke Access to disable the integration.

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