How can we help you?

Karat^

Karat conducts highly predictive technical interviews that power world-class hiring processes for leading organizations.

Greenhouse Recruiting’s integration with Karat allows your organization to seamlessly add Karat's assessment to a job's interview plan, invite candidates to the Karat interview, and receive result summaries within Greenhouse. In this article, we will cover how to: 

 

Enable the Greenhouse Recruiting / Karat Integration 

Begin by navigating to the Karat platform, Central. Click Settings on the left-hand pane, then click Integrations. Copy the Interview – Assessment API Key. If you are also using Karat Code Challenges, copy the Code Challenge – Assessment API Key as well.

Screen_Shot_2020-01-08_at_4.44.30_PM.png

With your API key(s) copied, fill out the form at www.greenhouse.io/asksupport or click here to open a ticket.

Note: Do not send the API key in this initial email.

The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support Team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your integration is enabled.

 

Add Karat Stage to Job's Interview Plan

Once the Greenhouse Recruiting / Karat integration is enabled for your organization, you will be able to add the Karat assessment as an interview stage. 

To do this for an existing job, navigate to a job (All Jobs > Job Name) and click Job Setup from the Job navigation bar. From the Job Setup page, navigate to Interview Plan on the left-hand panel.

mceclip0.png

Scroll down the page and click + Add a Stage

Screen_Shot_2018-07-23_at_9.10.09_AM.png

From the Add Stage dialog box, select the Karat stage. When finished, click Add to apply the stage to the job's interview plan.

image-0.png

The Karat stage is added to the job's interview plan. 

 

Configure Karat Interview Stage

Once the stage has been added to the job's interview plan, click Edit

mceclip1.png

On the Edit Interview Kit page, click Edit Take Home Test. Use the provided dropdown menu to choose from the assessments you have previously set up in Karat. 

Select the appropriate assessment and assign at least one Greenhouse Recruiting user to grade/review submitted assessments. When finished, click Save

Note: Keep in mind that all configuration of the assessment itself, as well as the email template, will be configured by your Karat Account Manager.  

 

Send and Review the Test 

When candidates are moved into the Karat interview stage, Greenhouse Recruiting will display a Send Test link on their candidate profile. 

image-1.png

Note: When you send a test from Greenhouse Recruiting, the interview instructions are actually sent by Karat.

The status of the assessment will be viewable in Greenhouse Recruiting.  

image-2.png

Once the candidate has submitted their test, their activity feed will contain a link to view the submitted test on Karat.

Screen_Shot_2020-01-08_at_4.47.01_PM.png

 

Enable Status Updates and Advanced Insights with Karat 

Now that you are able to invite candidates to the Karat interview and receive results all within Greenhouse Recruiting, you can also extend your integration using Greenhouse Recruiting's Harvest API. This will allow you to: 

  • Receive Karat status updates in Greenhouse Recruiting
  • Enable Karat to align the bar based on onsite outcomes
  • Enable Karat to provide advanced insights

To enable status updates and advanced insights, you will need to create a Harvest API key in Greenhouse Recruiting, and add the Harvest API key to Karat. Creating a Harvest API requires the developer permission Can manage ALL organization’s API Credentials.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon configure.png > Users > Your Name.

 

 

 

Step 1: Get your Harvest API key

  1. In Greenhouse, click the Configure tab
    1. Click Dev Center
    2. Click API Credential ManagementScreen_Shot_2020-01-08_at_4.47.44_PM.png
    3. From the Type drop-down menu, select Harvest. In the description, write “Karat”Screen_Shot_2020-01-08_at_4.48.20_PM.png

      Step 2: Set up permissions

      The last step will take you to the Manage API Key Permissions page, where you can select the endpoints that the key will give Karat access to. 

      Please contact your Karat Account Manager for the endpoints Karat requires for this integration. 

      Step 3: Complete setup

      Once you’ve selected the endpoints in Step 2, click “Update.” 

      Step 4: Add Harvest Key to Central

      Once you have updated your Greenhouse settings you will need to add the Harvest API key you created in the last step to Central. To do that, log in to Central and navigate to Settings > Integrations, then enter your key.

      Screen_Shot_2020-01-08_at_4.49.19_PM.pngOnce these steps are complete your Karat Account Manager will be in touch confirming that the integration was successful.