> ## 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 the following 2 permissions and click **Save**:

    * User Roles
    * Users
      ​

    <Frame>
      <img src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/greenhouse/image6.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=2161448f90c67fee293e05dab2292d6c" alt="Step 4" width="980" height="1652" data-path="images/greenhouse/image6.png" />
    </Frame>
  </Step>
</Steps>

## Retrieve your Greenhouse User ID

Per the Greenhouse documentation, you can locate a User ID by going to the **Users** page, select a User with the **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/image7.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=62a1a8d4544da8e31ea92d267217b3f9" alt="Step 7" width="964" height="1254" data-path="images/greenhouse/image7.png" />
</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!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
</ul>

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