# Greenhouse integration

> Learn how to integrate Dover with Greenhouse ATS to automate candidate management and prevent duplicate outreach.

## Overview

Dover's Greenhouse integration enables automated candidate management and synchronization between both platforms.

:::note
Note: This integration is only available for paid Dover plans.
:::

### Key features

- Prevents duplicate candidate outreach
- Automatically adds candidates to Greenhouse
- Syncs candidate status between systems
- Manages inbound applicants from job boards
- Tracks interview stages and feedback

---

## Initial setup

### Connect Dover to Greenhouse

#### 1\. Create Dover source

1. Click the **Configure** icon in Greenhouse
2. Select **Custom Options**
3. Click **Sources**
4. Click **Create New Source**
5. Name it "Dover" (exact spelling required)

#### 2\. Create Harvest API key

Note: You must have "Can manage ALL organization's API Credentials" permission.

1. Click the **Configure** icon
2. Navigate to **Dev Center**
3. Click **API Credential Management**
4. Click **Create New API Key**
5. Select **Harvest** from API Type dropdown
6. Add "Dover Harvest API Key" as Description
7. Configure required permissions:
   - Activity Feed
   - Applications
   - Candidates
   - Custom Fields
   - Jobs
   - Job Posts
   - Job Stages
   - Offers
   - Prospects
   - Rejection Reasons
   - Scheduled Interviews
   - Sources
   - Users

#### 3\. Connect to Dover

1. Navigate to **app.dover.io/setup/company/ats-settings**
2. Select **Greenhouse**
3. Enter your:
   - Greenhouse subdomain
   - Harvest API key
4. Click **Save and Validate**

---

## Job configuration

### Sync jobs to Greenhouse

1. Go to **ATS Settings** in Dover
2. Click **Edit** next to your job
3. Under **Select ATS Job**, choose the corresponding Greenhouse job
4. Select which teammate to post on behalf of (often the hiring manager or recruiter)
5. Click **Save**

### Enable applicant sync

1. Go to **ATS Settings**
2. Edit your Dover job
3. Under **Inbound**, toggle on **Sync applicants**
4. Click **Save**

---

## Candidate management

### Information synced to Greenhouse

- Candidate name
- Email address
- LinkedIn profile (under Details)
- Dover source tag
- Email correspondence (Activity Feed)
- Scheduled interview details
- Initial call notes (with Dover Interviewer)

### When candidates are added

You have two options:

- **Add everyone**: Candidates added as prospects when reached out
- **Add qualified only**: Candidates added when approved, placed in "First Call" stage

Note: Sync typically takes up to 1 hour.

### Stage management

- Dover maps interview plan stages to Greenhouse stages
- Candidates appear in corresponding stages in both systems
- Rejections and withdrawals sync between systems
- Changes may take up to 24 hours to sync back to Dover

### Inbound candidates

For applicants already in Greenhouse:

- **Dover Recommends Advance**: Passed job criteria
- **Dover Recommends Reject**: Failed job criteria

---

## Additional features

### Reporting analytics

To enable reporting analytics:

1. Navigate to **Dev Center**
2. Click **API Credential Management**
3. Edit the Dover API key permissions
4. Add reporting analytics permissions
5. Click **Save**

Note: Allow 1-2 hours for data processing.

### Candidate exclusion

- Dover prevents outreach to candidates with activity in the past year
- Applies to both candidates and prospects
- Helps prevent duplicate outreach

---

## Frequently Asked Questions

### Why can't I make changes in Greenhouse?

For Dover's automation to work correctly, approve/reject candidates in Slack or Dover App rather than Greenhouse. Changes will sync to Greenhouse within 24 hours.

### Why aren't ATS links working?

Check your Greenhouse subdomain configuration. Common domains include:

- app.greenhouse.io
- app2.greenhouse.io
- app3.greenhouse.io
- yourcompanyname.greenhouse.io

### How do I find my job in Greenhouse?

Note that internal job names may differ from external titles. To find the correct job:

1. Navigate to **Jobs** in Greenhouse
2. Select your job
3. Use the internal job name shown in the interface

### Can I move candidates between jobs?

Candidates should be moved through Dover to maintain tracking. Contact support for assistance with job transfers.

### How do I edit API permissions?

1. Click **Configure** icon
2. Navigate to **Dev Center**
3. Click **API Credential Management**
4. Click **Edit** next to your API key
5. Update permissions
6. Click **Save**

For additional help, reach out to your contact at Dover.