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

Enable the Greenhouse Recruiting / Karat integration

Retrieve your API key from Karat^

To begin the process of enabling the Karat^ integration, navigate to the Karat^ platform, Central and click Settings on the left-hand panel. Next, select Integrations and copy the Interview – Assessment API Key.

If your team utilizes Karat^ Code Challenges, copy the Code Challenge – Assessment API Key as well.

Screen_Shot_2020-01-08_at_4.44.30_PM.png

Once you have received the credentials listed above, click here to open a ticket with the Greenhouse Technical Support team.

Note: Do not send the credentials in this initial email.

The Greenhouse Technical Support team will respond with a SendSafely link for you to provide the credentials. A notification will be sent to the Greenhouse Technical Support team after you have entered the credentials, and they will email you to confirm your credentials have been set up in your account and your integration is enabled.

Note: To verify your identity, the Greenhouse Technical Support team might request you provide a Support Verification Code before adding the credentials to your organization's account.

After providing your created key and completing the full integration steps, you'll be able to add the Karat^ stage to your interview plans. 

Create a new Harvest API key in Greenhouse Recruiting 

To configure the Greenhouse Recruiting / Karat^ integration, you'll also 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.

Use the Karat^ integration in Greenhouse Recruiting 

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^

Note: If you want to automate assessments being sent to your candidates, create a stage transition rule.

Once configured, assessments will be triggered to send automatically after a candidate moves into the partner assessment stage. 

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

Enable scheduling statuses with Harvest API

The Karat^ integration additionally supports posting notes to the candidate 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 account 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.

Additional resources

For additional questions or troubleshooting when using the Karat^ integration, reach out to support@karat.com.