Make better hiring decisions with Alva. Combining psychology with technology like AI and machine learning, our digital platform gives you predictive and unbiased insights into the personality and logical abilities of your candidates.

Greenhouse Recruiting’s integration with Alva allows you to send tests to candidates and receive their results automatically.

Create a Harvest API key for the Alva integration

To configure the Greenhouse Recruiting / Alva 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 Alva integration.


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

  • API Type: Harvest
  • Partner: Alva Labs
  • Description: Alva Labs Harvest API Key


Verify that the following permissions are selected for the Alva integration:

  • Applications 
    • All permissions

Your Harvest API key for the Greenhouse Recruiting / Alva Labs integration is created and configured. 

Enter Harvest API key in Alva

In your Alva Account, go to Account > Integrations and click Add next to the Greenhouse logo.


Enter your Harvest API key into the available field and click Enable.


After that, you will receive an Alva API key. Provide this API key to the Greenhouse Technical Support team in the next step. 


Provide Alva API key to Greenhouse Technical Support team

Once you have obtained your API key, click here to open a ticket with Greenhouse Technical Support. 

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

The Greenhouse Technical Support team will respond with a SendSafely link for you to enter your API key. A notification will be sent to Greenhouse Technical Support 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.

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

Add Alva stage to job's interview plan

When you're adding a new stage to an interview plan, the Alva Labs stage will display in the list. Select this stage and add it to the interview plan.


Once the stage has been added to the job's interview plan, click Edit Take Home Test. Use the provided drop-down menu to choose assessments that you have previously set up in Alva. 

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

Note: Assessment configuration (including the email template) must be completed in Alva. 

Use the Alva integration

When candidates are moved into the Alva interview stage, Greenhouse displays a Send Test link.

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


For each candidate, you can click Send Test to trigger the workflow. After sending the test, the candidate will receive an email with instructions and you are able to see the test's status in either Alva or Greenhouse Recruiting.


The status of the assessment is viewable in Greenhouse Recruiting. 


Once the candidate has submitted their test, the Interview Kit contains a link to view the submitted test on Alva. You can also see the report directly in Alva for more detailed results and information about the test profile


Additional support

Please contact or your Alva Labs Customer Success Manager for troubleshooting assistance regarding the integration.