# Greenhouse

> Source: https://truto.one/docs/integration-guides/greenhouse/

Greenhouse connects with a Harvest API key.

:::callout{type="info"}
- You need a Greenhouse user who can manage all of the organization's API credentials.
:::

## Install the Greenhouse integration

Install Greenhouse from [Available integrations](https://app.truto.one/integrations/available/0a538a1f-dd51-470e-9de5-94be7ea4629b) in each environment you connect accounts from.

## Create a Harvest API key

1. In Greenhouse Recruiting, click the **Configure** icon on the navigation bar, then **Dev Center** on the left.
2. Click **API Credential Management**, then **Create new API credentials**.
3. Fill in the form:
   - **API type**: **Harvest**. The **Harvest API Key** field in Truto takes a Harvest key, not Harvest v3 (OAuth) credentials.
   - **Partner**: **Unlisted vendor**, or **Custom** if you're building your own integration.
   - **Description**: a name you'll recognise.
4. Click **Manage permissions**. Greenhouse shows the key only once: click **Copy**, store it somewhere safe, then click **I have stored the API key**.
5. Assign the permissions for the endpoints you need, and click **Save**.

See Greenhouse's [Create a Harvest API key for an integration](https://support.greenhouse.io/hc/en-us/articles/5888163769883-Create-a-Harvest-API-key-for-an-integration).

## Connect a Greenhouse account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own Greenhouse account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **Greenhouse**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **Harvest API Key** | Yes | The Harvest API key. See [Create a Harvest API key](#create-a-harvest-api-key). |
6. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.