Skip to main content
↑

Lever - HackerRank Interview Integration

  • Updated
Hide
In this article

Overview

HackerRank Interviews integrates with Lever to facilitate a seamless hiring process for companies. The Interview is an efficient tool for recruiters and technical managers to conduct interactive coding interviews with candidates located remotely. The integration with interview allows Lever users to directly start or schedule coding interviews with their candidates.

This article provides you with detailed steps to integrate Lever with HackerRank Interview. To know how to use the integration and schedule interviews from Lever, see HackerRank interviews with Candidates in Lever.

Lever - HackerRank Interview Integration

Prerequisites

In HackerRank for Work In Lever
  • You must own an Enterprise plan with a Recruiter license.
  • You must log in as a Company Admin user.
  • You must have a user account.
  • You must have relevant administrative permissions to the Integrations settings page.

Steps

Lever - HackerRank Interview integration is a two-step process that involves the following actions.

  • Obtaining Webhook signing token and API key from Lever
  • Obtaining webhook URL from HackerRank and connect it to Lever

Obtaining the Webhook Signing Token from Lever 

  1. Log in to Lever, click on the Settings option.lever_setting.jpg

Lever Settings

  1. Click on the Integration and API option from the left pane.Intergration_and_API.jpg

Integration and API tab in Lever

  1. Click on the Webhooks tab to open the Webhook configurations page.Webhooks.jpg

Webhooks Configuration Page

  1. Perform one of the following two options to generate the signing token specific to the Webhook URL,
    • Toggle the stage change button.
    • Click on the  '+ add webhook' option as shown below.Options.jpg

Options for generating the Webhook URL

  1. On either of the options (toggle switched on or '+' is clicked) a unique signing token is generated as shown below.Signing_token.jpg

Unique Signing token generation

  1. Copy the token and store it as it needs to be added to the HackerRank. 
  2. Click on the Partner Integrations tab.Partner_integration_.jpg
This page provides settings to enable integration with HackerRank
  1. Scroll down on the page to the Assessment section, and enable the HackerRank CodePair option. 
    Note: Although you'll need to enable the HackerRank CodePair, you will not need to copy the key that is generated.    Assessment.jpg
Enabling Lever's integration with HackerRank Interview

  1. After checking on the connection status of HackerRank Tests, scroll up to the top of the page and access the API Credentials Tab (At the top of the screen)
    Lever_API_Credentials.jpg
    API Credentials Tab within Lever

  2. From the API Credentials tab, scroll down to the Lever API credentials section. (As seen highlighted above within the API Credentials tab)

    • You'll then need to ensure that the Key that you'll be working with for HackerRank Tests and HackerRank Interviews has the proper Read and Write endpoints assigned, including both:
      • Create Candidate
      • List Posting
        • The Read endpoints and Write endpoints are two separate sections; make sure both fields are checked in each section.
          • Scroll down past the Read endpoints section (as seen below) to access the Write endpoints section.Read_Endpoints.jpg

Read endpoints within Lever API credentials

Obtaining the Webhook URL from HackerRank and Adding it in Lever

  1. Log in to HackerRank for Work as a Company Admin user.
  2. On the home page, click the arrow next to the user icon on the top right corner of the page, and select the Settings option.HR_settings_Lever.jpg
Accessing the settings page in HackerRank for Work
  1. Click on the ATS Integration option, and navigate to the Lever integration area.Lever_Configure.jpg

Lever Configuration

  1. In the respective fields, add the Lever API Key and Lever Webhook signing token, as shown below.image5.jpg
The HackerRank settings page with Lever integration fields
  1. HackerRank creates the Webhook URL. Copy this URL. The integration completes when you add this URL to Lever.image2.jpg                             The Webhook URL from the HackerRank settings page
  1. In Lever, navigate to the Webhooks tab on the Integrations and API page.
  2. Click on the Webhooks tab, and under the Webhook Configuration, turn on the Candidate Stage Change event. In Lever, this is the event trigger that sends an interview link request to interview.Candidate_stage.jpg

                                      The 'Candidate Stage Change' event trigger sends a request to interview

  1. Click on the Add Webhook option for the Candidate Stage Change event, and add the Webhook URL obtained from HackerRank.add_webhook.jpg
  2. Click on the Verify Connection button. When the URL is verified, you will see a checkmark displayed. You can include or remove the 'https://' from the HackerRank URL.
  3. url.pngAdding HackerRank's Webhook URL in Lever

In Lever, candidate profiles must meet the following requirements before the "Candidate stage change" event can trigger a request to HackerRank Interviews:

  1. A profile must have the candidate's name and a valid email address.
  2. A profile must include the "HackerRank CodePair" tag or be linked with a Job that has the same tag.

When the candidate stage is changed, an interview link is automatically added to the profile. Recruiters can click on this link to quickly start or schedule an online interview session to assess the candidate.

For more information, see HackerRank Interviews with Candidates in Lever.Candidate_profile.jpg

Candidate profile in Lever with the "HackerRank Interview" tag

Related articles