Lever Integration in headhuntr.io

To configure Headhuntr.io - Lever Integration, the access role of the user setting up the integration must be Super Admin in Lever. The user should also have an Admin role and a valid account in Headhuntr.io to configure this Integration.

If you are not an Admin user for Headhuntr.io, please contact your Account Manager at Headhuntr.io to help you with the integration.

The following steps need to be completed:

1. Lever OAuth Authentication
2. Webhook Configuration 

STEP 1: Lever OAuth Authentication

In the “Authorize” step of the configuration wizard, authorize Headhuntr.io to grant required permissions through the Lever OAuth process. Once you click the “Authorize” button, you can log in to your Lever account, review the permissions required by Headhuntr.io and click “Proceed” to complete the process.

Once you have completed this step, you will be redirected to the Configuration Wizard in Headhuntr.io and you can then configure the webhooks required for this Integration.

---

STEP 2: Webhook Configuration

To configure webhooks for the Headhuntr.io integration, you would require an Endpoint URL from Headhuntr.io. This information will be provided to you in the “Webhook” step of the ATS Configuration Wizard of Headhuntr.io. It can be used to configure all the required webhooks.
To configure webhooks for the integration, follow the steps listed below: 

• A. Click Settings in your Lever Account> Integrations and API
• B. Select API Credentials
• C. Select the following webhooks  
• Application Created 
• Candidate Stage Change 
• Candidate Archive Stage Change 
• Candidate Hired 
• Candidate Deleted 
• D. Select Add webhook and paste the endpoint URL for each webhook
• E. Copy the generated signature token for each webhook and paste it into Headhuntr.io  

To set up a new webhook, click Settings in your Lever account, then navigate to Integrations & API and click the Webhooks tab.

On this tab, select “Add Webhook” and paste the Endpoint URL provided on the “Webhooks” page of your Headhuntr.io ATS Configuration.

Copy the signature token generated and paste it into the configuration wizard Headhuntr.io into the Lever webhook form.

These steps can be repeated for other required webhooks. Lever will provide a signature token for each webhook, please copy-paste the corresponding signature tokens from Lever to Headhuntr.io.

Please note that it is not mandatory to configure all the webhooks, but it is recommended to configure the listed webhooks for all functionalities in Headhuntr.io to work.