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.
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.