Español

Articles in this section

See more

Greenhouse Integration

  • Updated
Follow

Integrate your Greenhouse and Vervoe account with these easy steps. 

 

Steps to establish the connection
Set Permissions to Receive and Score Candidate Results in Greenhouse
Using Vervoe in Greenhouse - After you establish the connection

 

Steps to establish the connection

  1. The Greenhouse integration is available to customers on our Growth or Enterprise plan. You must have accounts on both platforms to enable the integration. 

    Important Notes: 

    • This integration requires authentication from Greenhouse to complete set up which can take up to 48hrs`

    • Only the first score will show on the Greenhouse integration card for each candidate. Updates due to AI or manual grading are not updated in Greenhouse

    • Only special configured Team Members in Greenhouse are able to manually grade from the candidate card that’s in Greenhouse

    • The manual grade is visible via the activity feed in Greenhouse

    • Users must not be signed into both Vervoe and Greenhouse in the same window when viewing an integration card - security will

     

Getting Started

  1. Click on the image icon on the top right of your account and choose Integrations and choose Greenhouse in the left side panel.

  2. Move the toggle button to "Enable Greenhouse Integration"

  3. Send a request to Greenhouse to establish a connection

    1. Under Greenhouse API key, copy the key

    2. Go to Greenhouse Support Center and click Get help in top right hand corner. A widget called “How can we help” will expand in the bottom right hand corner.

    3. Type your query, e.g. “Enable Vervoe integration” and follow the instructions to open a support ticket.

pic.png

 
 

Set Permissions to Receive and Score Candidate Results in Greenhouse

 

Once the connection has been established and confirmed by Greenhouse support, you will need to generate a Harvest API key in Greenhouse and add this to your Greenhouse Integration page in Vervoe. This will allow you to receive and grade candidate answers right through Greenhouse. FULL Instructions on generating this key can be found here.



From the Greenhouse Support page and modified steps for Vervoe specifically:

To create a new Harvest API key, click the Configureicon 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.

 

Screenshot_of_Dev_Center_API_Credential_Management.png

 

From the API Credential Management page, click Create New API key.

 

Screenshot-of-create-new-API-key-button.png

 

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

  • API Type: Harvest
  • Partner: type Vervoe and select the name from he dropdown
  • Description: Vervoe Harvest API Key

Screenshot-of-manage-permissions-button.png

When finished, click Manage Permissions to generate the Harvest API key.

 

In the subsequent dialog box, click Copy to save your API key to your clipboard and store the API key in a secure location to provide to the partner.

 

Screenshot-of-created-api-key.png

 

Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full Harvest 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, add it to the partner integration page, and then revoke access to the original key.



On the subsequent page, confirm the correct permissions are assigned to your new API key, or assign the permissions yourself by clicking the appropriate checkboxes. See below for the permissions required for the Vervoe Harvest API key:

Under Candidates, select the following:

Get: Retrieve Candidate
Get: List Candidates
Post: Add Note

 

Under Users, select the following:

Get: Retrieve User
Get: List Users


Refer to the image below. 

image__1_.png

 

Once you have completed the steps above, add the Harvest API key you generated and copied and add it to your Vervoe integration page in Vervoe as shown in the example below.

mceclip1.png


Using Vervoe in Greenhouse

Once the integration is complete, all of your active assessments will automatically be available to select as a stage via your interview.

Adding the Vervoe Interview Stage

To add the stage to your Interview Plan:

  • Navigate to a specific job, and click the Job Setup tab

  • Click Interview Plan

  • Scroll down the page, and click the green + Add Stage button

  • Select Vervoe Assessment, and click the Add button

pic2.png


Configuring the Stage

Once the stage has been added, click Edit Take Home Test. From there, you will see a drop-down menu that reflects the assessment that you’ve previously set up in Vervoe. Select the appropriate assessment, assign at least one Greenhouse user to grade/review submitted assessment, and then click Save.

Keep in mind that all configurations of the assessment itself, as well as the email template, will need to be handled in Vervoe.  While you will click "Send Test" from within Greenhouse, the interview instructions are actually sent by Vervoe. 

Sending the Test

When candidates are moved into the Vervoe Interview stage, Greenhouse will display a Send Test link. While you will click "Send Test" in Greenhouse, the interview instructions will actually be sent through Vervoe.

The status of the assessment will be viewable in Greenhouse:

  • Take Home Test to be sent.

  • Waiting for the candidate to submit test

  • Scorecard due from <DESIGNATED_GRADER>

pic3.png

Reviewing Test Results

Once the candidate has submitted their assessment, the Interview Kit will contain a link to view this. The Vervoe candidate card looks like this:
pic4.png

 

Related articles