Enabling and using the headhuntr.io integration

Available for Roles Super Admin, Admin, Team Member, Limited Team Member
Can only be enabled by Super Admins
Permissions • (To enable) Manage API credentials and manage integrations
• (To use) Manage profiles and view associated postings
Packages LeverTRM, LeverTRM for Enterprise

The headhuntr.io integration automatically syncs potential, qualified, and interested candidates sourced in headhuntr.io to Lever. The seamless integration helps to streamline and keep track of communication between candidates and the hiring team throughout the recruiting process.

Setting up the headhuntr.io integration


You must be a team or organization with admin rights in headhuntr.io to install this integration.
  • In headhuntr.io, navigate to the 'Company Account Details' page
  • Select ATS Configuration in the export add-ons section
  • Under ATS Application, select Lever
  • Click Save & Proceed

ATS configuration page in headhuntr.io

  • Select Authorize in the next step
  • On the modal, log in to Lever
  • Review the list of requested permissions and click Accept

App authorization modal with listed permissions

  • You will be redirected to configuration wizard on headhuntr.io

Configuring the headhuntr.io integration

Webhook configuration

Once you have completed authorization, you will be redirected to the Configuration Wizard in headhuntr.io. 

Configuration Wizard in headhuntr.io

  • Copy the endpoint URL provided in the configuration wizard
  • In Lever, navigate to Settings > Integrations and API > Webhooks
  • On the 'Webhooks' page, enable the following webhooks by clicking the toggle to the on (blue position) if they are not already enabled:
    • Application Created
    • Candidate Stage Change
    • Candidate Archive Stage Change
    • Candidate Hired
    • Candidate Deleted
  • Copy the generated signature token for each webhook in Lever and paste it into headhuntr.io

Webhook tile in Lever settings

  • In headhuntr.io, select Add webhook and paste the endpoint URL for each webhook

User mapping

  • Proceed to the next step for user mapping
  • Map users in headhuntr.io to the users in Lever by providing their Lever Email ID
    • Only mapped users will be able to export candidates
    • At least one user should be mapped and active to complete the setup
  • Click Activate

Using the headhuntr.io integration

Exporting candidates from headhuntr.io to Lever

Once the configuration is activated, all the users who have the access to Lever will be able to export candidates to Lever from any stage in the requisition in headhuntr.io.

To export candidates from headhuntr.io to Lever, complete the following:

  • From the export icon, select Export to ATS
    • You may link a job and requisition (optional) while exporting the candidates

What the integration looks like in Lever

  • All the candidates exported from headhuntr.io will have their source listed as headhuntr.io on the candidate opportunity record
  • Candidates will be exported candidates to the 'New Lead' stage
  • Candidates will be added to Lever as a general opportunity if you have not associated a candidate with a job in headhuntr.io
  • If a job is selected while exporting, the candidates will be associated to the selected job posting on the their candidate opportunity record

Disabling the headhuntr.io integration

  • In Lever, navigate to Settings > Integrations and API
  • Under the 'Authorized Apps' tab, locate the headhuntr.io app
  • Click Revoke access to disable the integration
Was this article helpful?
0 out of 0 found this helpful