> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-mintlify-faq-auth-1778741451.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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/image1.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=06bec1ea2803621a03925d4bce6714ca" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/image2.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=acc1c1d44e077e7245914674bbc99598" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/image3.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=a8c54ed9a84664e51b7fe917f3c90589" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/greenhouse_permissions.gif?s=1ed86161a88d74bb16eb20fc16212d13" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/image4.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=e3da91b78ec349273c5311824c30b373" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/image5.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=46fcd3fae46d3d26fffcf50431f02d8c" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/10577285508763.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=dc125f194ce495a8c2b318ec528ae4e6" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/greenhouse/F5PLzgbq4ZEu0KA2pDzz_i82EQ0cbhBzSMcna6Er9.gif?s=b64f4c140e0af37b63c4c95ad48716c2" 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>