> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humanintelligence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Greenhouse

> Connect your Greenhouse account using the Harvest API v3.

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.

<Info>
  **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.
</Info>

## 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:

| Data Type    | What it enables                                             |
| ------------ | ----------------------------------------------------------- |
| Candidates   | Syncing contact info, resumes, and tags.                    |
| Applications | Viewing a candidate's history, current stage, and status.   |
| Jobs         | Mapping our internal workflows to your specific open roles. |
| Offers       | (Optional) Securely syncing compensation and start dates.   |
| Scorecards   | (Optional) Viewing interviewer feedback and ratings.        |

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

<Tip>
  Click into your Greenhouse connection any time to see resource-level health — exactly which data types are syncing successfully and which might need attention.
</Tip>