1. 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.
Step 1: 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.
Step 2: Have the user with Site Admin level permissions edit your user account's permissions by navigating to the cogwheel (1) that signifies settings. Then the user with Site Admin level permissions needs to click Users (2). He/she will then arrive at a new page where he/she needs to locate and click on your name.
Step 3: The user with Site Admin level permissions should scroll down to the User-Specific Permissions panel on your user page and expand the Developer Permissions dropdown menu (1) and then tick the box next to "Can manage ALL organization’s API Credentials"(2). When finished, click "Save" (3).
2. Getting an API-Harvest key from Greenhouse
Step 1: In the Greenhouse website, click on the cogwheel (1). Next click on Dev Center (2). Then click on "API Credential Management" (3).
Step 2: Click "Create New API Key".
Step 3: A dialogue box will appear. In the field connected to "API Type" (1) select the option "Harvest". In the field connected to "Partner (if applicable)" (2) select Alva Labs then click "Manage Permissions" (3).
Step 4: A new dialogue box will appear. Copy the API Key (1). Then click "Close" (2). Write Alva in the description field.
Step 5: Tick the box located just to the left of applications as shown in the screenshot below. Then scroll down and click "SAVE".
3. Getting an API Key from Alva Labs
Step 1: In Alva, go to your company Settings (1). If you can't access them, either ask an employee in your organization with the access level "admin" or reach out on Alva's Intercom. Next click on "Integrations" (2). Then click "Add integration" (3).
Step 2: Click on "Add" next to Greenhouse.
Step 3: Paste the Harvest API Key that you copied from step 4 in the previous section of the guide. Then click "Enable" (2).
Step 4: An Alva API Key will appear. Click on the eye-icon (1) in order to reveal the API Key (2) which you then copy.
Note: API Keys allow access to sensitive data and must be kept secret. If an API Key is shared in an email and your email is intercepted by a malicious third party or your email account is hacked, the hacker would be able to view and access your API Key.
4. Sending the Alva API Key to Greenhouse support
Step 1: Click HERE in order to open a ticket in greenhouse.
Step 2: Write that you would like to get a "SENDSAFELY" link to send your Alva API Key and the Greenhouse support team will then respond with a link.
Step 3: Safely send your Alva API Key to Greenhouse support.
Thank you for reading this guide! You are now done with setting up the integration between Alva and Greenhouse. You can now send and review Alva tests directly through Greenhouse. If you want to know how to do that click HERE.
Please contact firstname.lastname@example.org or your Customer Success Manager for troubleshooting assistance regarding the integration.