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. In this article, we will cover how to:


Configure user setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / Alva Labs integration, you will need the developer permission Can manage ALL organization’s API Credentials.

Contact a Greenhouse Recruiting 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.


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

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


Repeat as necessary for any other user that should have access to set up the integration.


Create Harvest API key for Greenhouse Recruiting / Alva integration

To create a Harvest API key for the integration, click the Configure icon Configure.png in the upper right-hand corner, and navigate to Dev Center on the left-hand panel. From the Dev Center page, click API Credential Management.


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


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

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

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Alva Labs.


In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Alva Labs in the next step. Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.


On the subsequent page, confirm the following permissions are assigned to your new API key:

  • Applications: 
    • All permissions

If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished. 

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 enable the Greenhouse integration.



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



Provide Alva API key to Greenhouse Support team

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

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.

Note: To verify your identity, the Greenhouse 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

Once the Greenhouse Recruiting / Alva integration is enabled for your organization, you will be able to add the Alva 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.


Scroll down the page and click + Add a Stage.


From the Add Stage dialog box, select the Alva Labs stage. When finished, click Add to apply the stage to the job's 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: Keep in the mind all configuration of the assessment itself, as well as the email template, must be completed in Alva. 


Send and review Alva tests

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



Get help

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