Who can set this up
You must have all of these permissions for the Guide <> Greenhouse integration to be successful:
You are a Site Admin in Greenhouse
You are an Admin in Guide
You have permission in Greenhouse to authorize third-party applications
Confirm access at My info if Dev Center is restricted.
What you get after connect
Data will be synced to Guide from Greenhouse:
Jobs, interview stages, and interview definitions
Candidates and applications, including stage changes
Scheduled interviews created or updated in Guide (when scheduling is enabled)
Timely updates via webhooks when data changes in Greenhouse
Step 1: Connect Greenhouse in Guide
Important: You must check the box to Authorize using a service account when authorizing
Important: You must be a Site Admin in Greenhouse
Log in to Guide and go to Settings → Integrations.
On the Greenhouse tile, click Connect.
In the popup window, type your Greenhouse email address then click Log in to Greenhouse. Log in to Greenhouse normally when prompted. (screenshot 1)
Check the box to Authorize using a service account then click Authorize. (screenshot 2)
When authorization succeeds, the popup will close and the Greenhouse tile will show Connected in Guide
Step 2: Set the default ATS sync user
Greenhouse requires attribution for many write actions. On the same Integrations page, under Default ATS sync user, choose the Greenhouse user Guide should use when the acting user is not mapped. Use a stable admin or service-style account, not a personal login that may be deactivated later.
Troubleshooting
Symptom | What to check |
Authorization finishes but Guide is not Connected | Pop-up blockers; run Connect again. If you see a “busy” message, wait briefly and retry. |
Data feels stale | Not all ATS webhooks show Connected — fix in Greenhouse or contact support. |
Scheduling or ATS writes fail | Default ATS sync user is set and maps to a valid Greenhouse user. |
Tile shows Update available instead of Connect | Finish authorization once (same Connect flow) so OAuth is fully linked. |
For authorization or scope errors, contact support@guide.co with your Greenhouse subdomain and a screenshot of Settings → Integrations.