Connected to Greenhouse with an API key? Greenhouse is retiring its legacy connection method at the end of August 2026. Reconnect using the new login flow before then to keep new hire data flowing into your Journeys. See Reconnecting an existing Greenhouse connection below.
Syncing Greenhouse with Donut pulls new hire details, start dates, and manager info into your Journeys automatically.
How to Connect Greenhouse to Donut
Log into the Donut dashboard and go to HRIS & ATS in the left sidebar menu.
Select the Connect HRIS or ATS button > Connect Greenhouse.
You’ll land on Greenhouse’s authorization page, which lists everything Donut will be able to access.
Check Authorize using a service account. This creates an org-level service account to own the connection, so it stays active even if your personal Greenhouse account changes.
Enter your email and click Log in to Greenhouse to sign in and authorize. (If you’re already signed in, the button reads Authorize.) Make sure you sign in to your production Greenhouse environment, not a sandbox.
You’ll return to Donut while the connection is verified and your Greenhouse data begins importing. Once the sync completes, you’re ready to set up auto-enrollment and Journeys.
What Donut can access
The authorization page shows the full list. Donut’s access is read-only and covers: candidates and prospects, applications and pipeline stages, jobs and openings, offers, user accounts and emails, and organization setup details like departments, offices, and custom fields. You can revoke access at any time from your Greenhouse account settings.
Reconnecting an existing Greenhouse connection
If your team originally connected Greenhouse with an API key, you’ll need to reconnect using the new login flow before the end of August 2026. Follow the interactive walkthrough to see the connection flow step by step. It takes about 30 seconds:
Go to HRIS & ATS in the Donut dashboard.
Click Reconnect on your Greenhouse connection.
Log in and authorize when Greenhouse prompts you.
Note: If you don’t reconnect before the end of August, your Greenhouse sync will pause and new hires will stop flowing into your Journeys until you reconnect.
Troubleshooting
Connected, but no data is coming through? Two things to check:
Make sure you authorized your production Greenhouse environment. If you have a sandbox, it’s easy to authorize the wrong one. Your Greenhouse Dev Center shows which apps are authorized in each environment.
Have a Greenhouse admin reconnect. If the authorizing user’s Greenhouse access is limited, the connection can succeed without data coming through.
If the connection doesn’t complete, contact our support team and we’ll get you sorted.
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.
When new hires come through
Donut pulls in a candidate as soon as their offer moves to Accepted in Greenhouse, and your auto-enroll rules apply at that point. Greenhouse syncs with Donut every 4 hours, so new hires show up in Donut within a few hours of accepting.
Donut doesn’t wait for a candidate to be Marked as Hired, which happens later in Greenhouse once the hire is finalized.
What needs to be true for a new hire to be enrolled
They match an auto-enroll rule. Rules check the fields Greenhouse sends. If a rule requires a field like employment type and that field is empty in Greenhouse, the candidate won’t match. Offices are hierarchical, so a rule for a country-level office like USA also covers the offices under it, like Florida.
Their work email is in Greenhouse Recruiting. Donut finds new hires in Slack by their work email, so it can’t match anyone whose work email isn’t entered in Recruiting.
Promotions and internal transfers
Any accepted offer with a new start date starts a new onboarding session, and that includes promotions and internal transfers. To keep internal moves out of new hire onboarding, add Source is not Internal Applicant to your auto-enroll rule. This works when your team sets the source to Internal Applicant for internal candidates in Greenhouse.
Using Greenhouse with an HRIS
Once a new hire syncs to your HRIS, Donut adds the Journeys from your HRIS rules to their existing session. Their Greenhouse Journeys stay in place.
New Feature: Improved Auto-Enrollment Logic
We've enhanced our HRIS/ATS integration by updating how it handles auto-enrollment for onboarding journeys, specifically supporting scenarios involving rehires and internal transfers:
How it used to work:
If a new hire previously had an onboarding Journey session, updates from HRIS/Greenhouse were not detected.
How it works now:
Donut now checks for active onboarding Journey sessions with pending scheduled messages:
If active future messages exist, they will exist in the same session.
If the previous onboarding session is complete (no pending messages), Donut applies auto-enrollment rules and starts a new onboarding session using the latest job start date from HRIS/Greenhouse.
This ensures that employees, such as internal transfers or rehires, experience a seamless onboarding process.
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.