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 completed 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 actually are 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's platform.

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, then 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.

Users.png

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu. 

Select Can manage ALL organization’s API Credentials so that a check is in the checkbox. When finished, click Save.

One_permission.png

To create a Harvest API key for the Greenhouse Recruiting / Karat integration, click the Configure icon in the upper right-hand corner. Navigate to Dev Center on the left-hand panel. 

From the Dev Center page, click API Credential Management

Dev_Center_-_API_Credential_Management.png

From the API Credential Management page, click Create New API Key to generate the API key for Karat.

Create_new_API_key.png

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.

mceclip0.png

On the Manage API Key Permissions page, grant the Karat Harvest API key the permissions provided to you by your Karat Account Manager. If you have not received information around this, please contact your Karat Account Manager for the endpoints Karat requires for this integration. When finished, click Update.

Once you have created the Harvest API key in Greenhouse Recruiting, you will need to add the Harvest API key to Central. To do so, log into Central and navigate to Settings Integrations, then paste the Harvest API key created in Greenhouse Recruiting. 

Screen_Shot_2020-01-08_at_4.49.19_PM.png

Once you have completed these steps, your Karat Account Manager will contact you confirming the integration was successful.