Greenhouse Recruiting’s integration with Dover allows users to track candidates through all stages of the hiring process and prevent duplicate outreach by automatically adding Dover candidates to Greenhouse and excluding candidates already in Greenhouse from Dover outreach. In this article, we will cover how to:
- Configure User Setup Permissions in Greenhouse Recruiting
- Create a Harvest API Key for the Greenhouse/Dover Integration
- Create a Dover Source in Greenhouse
- Provide the Harvest API Key to Dover During Onboarding
- Use the Dover/Greenhouse Integration
- When are candidates added?
- How are candidates tracked?
- Navigating from Dover to Greenhouse
- Troubleshoot Common Issues
- Dover ATS Links Not Working
- Get Help
Configure User Setup Permissions in Greenhouse Recruiting
In order to enable the Greenhouse/Dover integration, you will need the developer permission Can manage ALL organization’s API Credentials.
Contact a Greenhouse 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 > Users > Your Name).
The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.
Select Can manage ALL organization’s API Credentials so that 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 a Harvest API Key for the Greenhouse/Dover Integration
To create a Harvest API key for the integration, click on the Configure icon in the upper right-hand corner. 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 Dover.
In the Create New Credential dialog box, make the following selections:
- API Type: Harvest
- Partner: Dover
- Description: Dover Harvest API Key
When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Dover.
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 Dover 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:
On the Manage API Key Permissions page, assign the following permissions to the API key: Applications, Candidates (DELETE permissions optional), Tags, Users (DELETE permissions optional), Jobs (DELETE permissions optional), Job Stages, Rejection Reasons, Sources, Prospect Pools. When finished, click Update.
Place a check in the box next to the appropriate permission. Click Save when finished.
Your Harvest API key for the Greenhouse/Dover integration is created and configured.
Create a Dover Source in Greenhouse
In order to tell which candidates in your Greenhouse were added by Dover, you will need to create a Dover source. All Dover candidates will be labeled with this source. Click the Configure icon in the upper right-hand corner and select Custom Options from the left-hand panel.
Select Sources from the subsequent page.
Click Create New Source.
Select “Other” from the dropdown menu and enter “Dover” as the source. See this article for more details.
Provide the Harvest API Key to Dover During Onboarding
Navigate to http://app.dover.io/setup/company and select ATS Settings
Select Greenhouse from the dropdown under Which ATS do you use? Follow the steps listed to configure your integration:
- Provide the correct subdomain (ex. if your Greenhouse URL says app3.greenhouse.io, enter app3. into this field)
- Confirm you have created a Dover Source, as detailed above
- Enter the Harvest API Key you created in Greenhouse
- Confirm Dover has the correct permissions, as detailed above
Once you have completed setup using your Harvest API Key with correct permissions, you will see the following confirmation screen:
To set up individual jobs, navigate to app.dover.io/jobs and click Setup next to the job you are onboarding. Navigate to ATS Settings and select the Greenhouse Job Name and the user we should post on behalf of from the dropdown menus. The user you select must have full access to the job. Dover will use the selected user ID to add and make all edits to candidates.
When finished, click SAVE at the bottom of the page. Contact firstname.lastname@example.org with any questions.
Using the Dover/Greenhouse Integration
When are candidates added?
By default, candidates will be added to your Greenhouse when they are interested and you approve them in Dover. Candidates are added to the stage in your Greenhouse that corresponds to the first stage of your interview plan, and you can select the appropriate stage during onboarding. It may take up to 1 hour for candidates to sync to Greenhouse.
Dover also has the option to add all candidates that we contact as prospects. Speak with your Dover Engagement Manager if you are interested in this option.
Dover won't reach out to anyone that has had any activity in Greenhouse for 1 year, regardless of the job they were sourced for. This applies to Greenhouse Prospects as well.
How are candidates tracked?
Dover will track candidates across stages in Greenhouse. If a candidate stage is updated in Dover, the candidate will be moved in Greenhouse -- and vice versa.
- Recruiter Screen/Initial Call/etc → Initial Call
- Hiring manager screen/Technical Phone Screen/etc → Pre-onsite
- Onsite/Face-to-Face → Onsite
- Offer → Offer
If the candidate was rejected or marked as withdrew in Dover, they will be archived in Greenhouse.
Navigating between Dover and Greenhouse.
Accessing Greenhouse from the Dover app is very easy. If a candidate has been added to Greenhouse, you’ll find a link to their profile in your Greenhouse at app.dover.io/pipeline and on the candidate thread in Slack.
Troubleshooting Common Issues
ATS Links in Dover are not working:
If Dover is adding candidates to Greenhouse but the links in Slack or Email are not working, that means Dover is probably pointing to the wrong Greenhouse subdomain. If this is happening for you, please reach out to your Dover Support Owner and provide the URL you see when you login to Greenhouse.
I'm seeing job/user options listed on the Dover Onboarding Link, but I can't find the one I want.
When onboarding a new job through Dover, if the dropdown menus on the ATS Settings page in the Dover app are showing some results but not the one you're looking for, check first to be sure the job is active in Greenhouse. Dover only shows active jobs.
Note that the internal job name (in your Greenhouse) and external job name (shown to candidates in job boards and careers pages) can be different. Please find the internal job name as that's what we'll be displaying in the selector.
This may also occur because you have more than 100 active jobs or users. If this is the case, please follow the steps below to provide our support team with your Job Name and ID and we'll get it taken care of on the backend.
The Job ID is specific to the job we are sourcing, and will change from role to role. To find this:
- Navigate to Greenhouse
- Click on Jobs
- Select the job we are sourcing for
- Copy the #'s from the tail of the domain slug (example below the Job ID: 4145802003
- Send it to us on Slack
How to Get Help
Please contact email@example.com or reach out to your Dover Support Owner in Slack for troubleshooting assistance regarding the integration.