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:
Log into the Donut dashboard and go to HRIS in the left sidebar menu
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:
Log into your Greenhouse account
Click the gear icon in the top-right corner to open the Configure section
Select Dev Center in the left sidebar menu
Click "API Credentials" in the left sidebar menu.
5. Click: “Create new API credentials”
6. In the “Create new credential” window:
Select Harvest for the API Type
Select Unlisted Vendor under Partner
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.
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:
Check the "I have checked the above permissions" box
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.