> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/image1.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=ee36fc7eac1c8b08e3a49000c2fc6c15" 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/image2.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=96f97213641660c983a809dcf9c48008" 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/image3.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=5daf4e243f809b46cc6de9ee69f6054a" 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/greenhouse_permissions.gif?s=9c841991e75103bdf786255d56c75e29" 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/image4.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=165fbd433abdbab0c4fa5ee385243002" 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/image5.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=c99e800aec501cfe44bfe75a8bcd2747" 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/10577285508763.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=c83d0011c89f6742d5f231c58da72864" 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/F5PLzgbq4ZEu0KA2pDzz_i82EQ0cbhBzSMcna6Er9.gif?s=9d5885998bbb702ded2d720617cf690a" alt="Step 7" width="640" height="354" data-path="images/greenhouse/F5PLzgbq4ZEu0KA2pDzz_i82EQ0cbhBzSMcna6Er9.gif" />
</Frame>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

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