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

# Greenhouse

> If you have been directed to StackOne to integrate with Greenhouse, the following steps will help you understand the process and any necessary actions to configure successful integration.

<Warning>
  This guidance assumes you have Admin privileges for your Greenhouse account.
</Warning>

## Generating Harvest API Key

<Steps>
  <Step title="Open the Configuration Page">
    Click on Configure gear ⚙️ and open Dev Center > API credentials.
    ​

    <Frame>
      <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/image1.png?fit=max&auto=format&n=25_Td-yCcpPuw8-v&q=85&s=4cbcc7ddd433c0d15bc067aaaadcbb27" alt="Step 1" width="2880" height="1622" data-path="images/greenhouse/image1.png" />
    </Frame>
  </Step>

  <Step title="Create a New API Key">
    Click Create new API key. Specify the following parameters:

    API type – Harvest

    Partner – Custom

    Description – "Describe\_your\_integration"
    ​

    <Frame>
      <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/image2.png?fit=max&auto=format&n=25_Td-yCcpPuw8-v&q=85&s=ef03ce85b5215ce199b2d83487e11134" alt="Step 2" width="2880" height="1220" data-path="images/greenhouse/image2.png" />
    </Frame>
  </Step>

  <Step title="Generate and Save the API Key">
    Click Manage permissions.

    Copy your newly generated API key to a safe place. Then click I have stored the API key.

    <Frame>
      <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/image3.png?fit=max&auto=format&n=25_Td-yCcpPuw8-v&q=85&s=ac6fff7e30b412b3974eeceed7c155fd" alt="Step 3" width="1212" height="718" data-path="images/greenhouse/image3.png" />
    </Frame>
  </Step>

  <Step title="Enabling Permissions">
    In the Manage permissions page, enable Select all and click Save.
    ​

    <Frame>
      <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/greenhouse_permissions.gif?s=1a3871c944c0cbabfd0e56719180e98c" alt="Step 4" width="960" height="542" data-path="images/greenhouse/greenhouse_permissions.gif" />
    </Frame>
  </Step>
</Steps>

## Generating Job Board API Key

<Steps>
  <Step title="Create Job Board API Key">
    In the API credentials page, click Create new API key. Specify the following parameters:

    API type – Job Board

    Partner – Custom

    Description – "Describe\_your\_integration"

    <Frame>
      <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/image4.png?fit=max&auto=format&n=25_Td-yCcpPuw8-v&q=85&s=f9821649c98cbd67af3a181ec565769e" alt="Step 4" width="2880" height="1617" data-path="images/greenhouse/image4.png" />
    </Frame>

    Click Create.
  </Step>

  <Step title="Save the API Key">
    Copy your Job Board API key to a safe place. Then click I have stored the API key.

    <Frame>
      <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/image5.png?fit=max&auto=format&n=25_Td-yCcpPuw8-v&q=85&s=fb6150d495c4cc750f94a6415b4c8f84" alt="Step 5" width="1204" height="706" data-path="images/greenhouse/image5.png" />
    </Frame>
  </Step>
</Steps>

## Retrieve a greenhouse User ID

Per the Greenhouse documentation, you can get a user ID by going to the users page, select a user with Site Admin permission and retrieve the user ID present in the URL:

Screenshot of an example user ID

<Frame>
  <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/10577285508763.png?fit=max&auto=format&n=25_Td-yCcpPuw8-v&q=85&s=ea17ba5325671135634dcaaf1d8d2188" alt="Step 6" width="1827" height="444" data-path="images/greenhouse/10577285508763.png" />
</Frame>

## Connect with StackOne

Enter the gathered details in the relevant inputs and proceed by clicking the Connect button.

<Frame>
  <img src="https://mintcdn.com/stackone-hub/25_Td-yCcpPuw8-v/images/greenhouse/F5PLzgbq4ZEu0KA2pDzz_i82EQ0cbhBzSMcna6Er9.gif?s=b44fe0ae2b345d9ff8d074d6b2153336" alt="Step 7" width="640" height="354" data-path="images/greenhouse/F5PLzgbq4ZEu0KA2pDzz_i82EQ0cbhBzSMcna6Er9.gif" />
</Frame>

## Useful Links

<Card title="API Reference" icon="link" href="https://developers.greenhouse.io/harvest.html">
  [https://developers.greenhouse.io/harvest.html](https://developers.greenhouse.io/harvest.html)
</Card>