Skip to main content
To provide a seamless integration with our product, you will need to connect your Greenhouse account using the Harvest API v3. This connection allows us to securely sync the specific data you need — like candidates, jobs, and applications — while giving you full control over exactly what information we can access.

​
How the Connection Works

Harvest v3 uses modern OAuth 2.0 security. Instead of a single static password, the connection uses a Client ID and Client Secret to generate temporary “access tokens.” This is safer and more performant than older API versions.

​
The “On-Behalf-Of” Requirement

For security auditing, Greenhouse requires every action taken by an integration to be associated with a real user in your system.
What you’ll need: A User ID from a Greenhouse user (typically a Site Admin or a dedicated “Integration User”). Any notes or status changes our product makes will appear in Greenhouse as being done “on behalf of” that user.

​
Your Integration Options

When you click Connect, you will be asked to provide credentials for specific “scopes” or permissions. You have total control over which “buckets” of data you share:

​
Security & Rate Limits

  • Least Privilege: We only request access to the data necessary for the features you use. You can revoke these permissions at any time within your Greenhouse Dev Center.
  • Auto-Throttling: Greenhouse limits the speed of data transfers (usually 50 requests every 10 seconds). Our system automatically manages this to ensure your Greenhouse account stays snappy and responsive for your recruiting team.
Click into your Greenhouse connection any time to see resource-level health — exactly which data types are syncing successfully and which might need attention.