Lever - CodePair integration

HackerRank's CodePair integrates with Lever to facilitate a seamless hiring process for companies. CodePair is an efficient tool for recruiters and technical managers to conduct interactive coding interviews with Candidates located remotely. The integration with CodePair 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's CodePair. To know how to use the integration and schedule CodePair interviews from Lever, see CodePair interviews with Candidates in Lever.

Prerequisites

The integration involves a 2-step process:

• Step 1: Obtaining the Webhook Signing token and API Key from Lever - for real-time data integration between Lever and HackerRank accounts.
• Step 2:  Obtaining the Webhook URL from HackerRank and adding it in Lever - To send Lever's requests to CodePair.

Step 1: Obtaining the Webhook Signing Token and API key from Lever 

1. Log in to Lever, and click Integrations from the Settings menu. 

2. Under Webhook signing token, click Regenerate and copy the token.  

3. Click the Partner Integrations tab.

4. Scroll down in the page to the Interviewing section, and enable the HackerRank CodePair option.

Step 2: Obtaining the Webhook URL from HackerRank and adding it in Lever

1. Log in to HackerRank for Work as a Company Admin user.
2. In the home page, click the arrow next to the user icon on the top right corner of the page, and select Settings.

3. Click API access, and navigate to the Lever integration area.
4. In the respective fields shown below, click   (edit) to add the API Key and the Webhook signing token obtained from Lever, and click  (save).

5. HackerRank creates the Webhook URL. Copy this URL. The integration completes when you add this URL in Lever.

                             The Webhook URL from the HackerRank settings page

6. In Lever, navigate to the Webhooks tab in the Integrations page.
7. Click the Webhooks tab, and under Webhook Configuration, turn-on the Candidate Stage Change event. In Lever, this is the event trigger which sends an interview link request to CodePair.

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

8. Click Add Webhook for the Candidate Stage Change event, and add the Webhook URL obtained from HackerRank.
9. Click Verify Connection. When the URL is verified, you will see a check mark displayed. You can include or remove the 'https://' from the HackerRank URL.

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

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 which has the same tag.

When the Candidate stage is changed, a CodePair link is automatically added in the profile. Recruiters can click this link to quickly start or schedule an online CodePair session to assess the Candidate.

For more information, see CodePair Interviews with Candidates in Lever.