Skip to main content
Syncing Greenhouse ATS with Donut

Learn how to sync your Greenhouse ATS with Donut to pull new hire details, start dates, and manager info into Journeys.

Essence avatar
Written by Essence
Updated over 2 months ago


Important: To connect Donut with Greenhouse, you'll need a specific permission in Greenhouse. Users can be of any type in Greenhouse, but they must have the 'Manage ALL organization's API Credentials' permission granted.


How to Connect Greenhouse to Donut

1. Start the Connection Process:

  1. Log into the Donut dashboard and go to HRIS in the left sidebar menu

  2. Select the Connect HRIS or ATS button > Connect Greenhouse ATS


2. Enter Your Greenhouse URL

You can find your URL anytime you are logged in to the Greenhouse dashboard. e.g. https://yourcompany.greenhouse.io/) This is typically in the following format:

https://app123.greenhouse.io

Replace "app123" with your specific Greenhouse subdomain.


2. Provide Your Greenhouse API Key

You'll need to enter your Greenhouse API Key. To create one:

  1. Log into your Greenhouse account

  2. Click the gear icon in the top-right corner to open the Configure section

  3. Select Dev Center in the left sidebar menu

  4. Click "API Credentials" in the left sidebar menu.


5. Click: “Create new API credentials”



6. In the “Create new credential” window:

  1. Select Harvest for the API Type

  2. Select Unlisted Vendor under Partner

  3. In the Description field, you can provide any description that will help you identify the purpose of the API key. It does not impact functionality.

  4. Click the Manage permissions button.


7. Copy the API Key and select "I have stored the API key"

Note: You will not be able to copy this API Key again, so please store it safely!


8. Paste the API Key in the designated field in Donut:


3. Select Required Fields in Greenhouse

To ensure Donut receives the necessary data, you need to grant specific permissions in your Greenhouse console. All of the required permissions are nested under the ”Harvest V1” API.


Note: You may need to click the arrow next to a section to expand the permissions listed below.

In the Greenhouse dashboard, select the following required fields:

Applications

  • Get: Retrieve Application

  • Get: List Applications

Candidates

  • Get: Retrieve Candidate

  • Get: List Candidates

  • Get: Get Hiring Team

Jobs

  • Get: List Application's Offers

  • Get: Retrieve Application's Current Offer

  • Get: Retrieve Offer

  • Get: List Offers

Users

  • Get: Retrieve User

  • Get: List Users


4. After setting up permissions in your Greenhouse Dashboard, return to Donut to complete the connection:

  1. Check the "I have checked the above permissions" box

  2. Click the "Next" button

Donut will automatically test your API key to ensure everything is properly configured.

  • If everything looks good: You'll be able to set up your first Journey right away, and your Greenhouse data will begin syncing in the background.

  • If there's a problem: Donut will show you exactly what needs to be fixed, so you can quickly make the necessary adjustments.


5. Data Synchronization

Once you've completed the setup, Donut will automatically start importing your Greenhouse data. You'll receive a notification as soon as everything is synced.


Having trouble? Our support team is ready to help! Contact Donut support by clicking the purple Donut icon in the lower right of your screen if you encounter any issues during the process.

Did this answer your question?