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 in Greenhouse Recruiting.

Reach out to support@karat.com to learn more about getting this integration set up.

Retrieve your API key from Karat

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

Set up the Karat^ integration

After you've retrieved the API key, follow the steps in this article to set up the assessment stage in your interview plans.

Once you've set up your interview plans and configured your take-home test, you'll be able to send the test to candidates.

Send and review a test with Karat^

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 in 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 configure the Greenhouse Recruiting / Karat^ integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Karat^ integration.

Credentials

In the Create New Credential box, make the following selections:

  • API type: Harvest
  • Partner: Karat^
  • Description: Karat^ Harvest API key

Permissions

Select the Karat^ Harvest API key the permissions provided to you by your Karat^ Account Manager.

If you have not received information about this step, contact your Karat^ Account Manager for the endpoints Karat^. 

Add Harvest API key to Karat^

Once you have created the Harvest API key in Greenhouse Recruiting, you will need to add the Harvest API key to Central.

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 to confirm the integration was successful.

Enable scheduling statuses with Harvest API

Karat^ also supports posting notes to the activity feed with Karat^ scheduling statuses (such as "Karat^ interview scheduled," "Karat^ interview cancelled,") and a summary of results.

Karat.png

Note: To enable these notes, you must have the POST: Add Note selected when creating your Harvest API key. Talk to your Karat^ Customer Success Manager or Solutions Engineer for more information on the correct API permissions for your account.

Once you’ve set up the Harvest API key, create a new Site Admin user in Greenhouse Recruiting with the name you would like to be associated with published results. (for example, a user named Karat^). 

After the user has been created, find the user ID in the URL bar for the specific user and copy it to your clipboard. 

karat2.png

Log into Central and add the value in the User ID for Pushing Updates field. (Settings > Integrations > Harvest Settings > User ID for Pushing Updates)

karat3.png

Note: The Harvest API key must be added before you’ll see the field for inputting the User ID. Providing the User ID does not grant any additional permissions to Karat and is used solely for publishing status updates.