Set up your Greenhouse and Vervoe accounts to work seamlessly together by following the steps below. This guide covers everything from connection setup to reviewing candidate results.
1. Establishing the Connection
The Greenhouse integration is available for customers on Vervoe's Growth or Enterprise plan. To enable the integration, you’ll need active accounts on both platforms.
Important Notes:
- Integration setup requires authentication from Greenhouse and may take up to 48 hours.
- Only the initial Vervoe score appears in Greenhouse. Updates due to AI or manual grading are not synced.
- Only specific Greenhouse team members can manually grade within Greenhouse.
- Manual grades appear in the candidate's Greenhouse activity feed.
- Do not stay logged into both platforms in the same browser window when viewing an integration card—this can cause security issues.
Steps to Connect:
- Click the image/user icon in the top-right of your Vervoe account.
- Select Integrations, then choose Greenhouse from the left-hand panel.
- Toggle the switch to Enable Greenhouse Integration.
- Copy the Greenhouse API Key displayed.
- In the Greenhouse Support Center, click Get Help in the top-right.
- In the "How can we help?" widget, type “Enable Vervoe integration” and follow the prompts to open a support ticket.
2. Setting Permissions to Sync Candidate Results
After Greenhouse support confirms the connection, generate a Harvest API key in Greenhouse to allow data exchange.
Steps to Create the API Key:
- Click the Configure icon in Greenhouse.
- Navigate to Dev Center > API Credential Management.
- Click Create New API Key.
- In the dialog box:
-
API Type: Harvest
-
Partner: Type and select Vervoe
-
Description: Enter Vervoe Harvest API Key
-
- Click Manage Permissions.
- Copy and store the API key securely.
- Click I have stored the API Key.
Note: Once you confirm storage, you cannot access the full key again. Lost keys require a new key to be created and the old one revoked.
Required Permissions for the API Key:
Under Candidates:
- Get: Retrieve Candidate
- Get: List Candidates
- Post: Add Note
Under Users:
- Get: Retrieve User
- Get: List Users
Paste the copied API key into the Greenhouse Integration page in your Vervoe account.
3. Using Vervoe in Greenhouse
Once integrated, all active Vervoe assessments will be available within Greenhouse.
Adding the Vervoe Interview Stage:
- Go to a specific job in Greenhouse.
- Click the Job Setup tab.
- Select Interview Plan.
- Click + Add Stage, then choose Vervoe Assessment.
Configuring the Stage:
-
Click Edit Take Home Test.
-
Select your desired Vervoe assessment from the dropdown.
-
Assign at least one Greenhouse user to grade the test.
-
Click Save.
Note: All assessment setup and email templates must be configured in Vervoe. Although you click "Send Test" from Greenhouse, Vervoe delivers the test instructions.
Sending the Test:
-
Move a candidate into the Vervoe stage.
-
Click Send Test (Greenhouse UI).
Candidate status will update within Greenhouse as:
- Take Home Test to be sent
- Waiting for candidate to submit test
- Scorecard due from
Candidate Re-Invites:
- If the test was previously sent and not completed, the candidate will receive the invitation again.
- If the test was completed, the previous result appears—no new invite is sent.
Reviewing Results:
- After submission, the Interview Kit will include a link to the Vervoe candidate card.
- The card displays the assessment score and any manual grading (if applicable).
Need Help?
If you have any questions or need help getting set up, reach out to your Account Manager or contact us at support@vervoe.com.