> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Greenhouse (Job Board API) - How do I link my account?

# Overview

To authenticate with Greenhouse (Job Board API), you need:

1. **Board Token** - A unique identifier for your Greenhouse job board that allows public access to job listings.
2. **API Key** - Your Greenhouse (Job Board) API Key.

This guide will walk you through finding or generating these credentials within Greenhouse.

### Prerequisites:

* You must have an account with Greenhouse.

#### Step 1: Finding Your Board Token

1. Log into your [Greenhouse](https://app.greenhouse.io/users/sign_in) account and click the **Configure** ⚙️ icon on your navigation bar, then click **Dev Center**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/m2srw3HGtarsGGhR/integrations/all/greenhouse-basic/greenhouse_1.png?fit=max&auto=format&n=m2srw3HGtarsGGhR&q=85&s=98d4fe22e6fb742eb5c9ca285a06437b" width="1791" height="1232" data-path="integrations/all/greenhouse-basic/greenhouse_1.png" />

2. In the Dev Center, click **Configure Job Board**. Your **Board Token** will be listed next to the heading `Your Board Token`.

#### Step 2: Generating Your Greenhouse API Key

1. From the same **Dev Center** page, click **API Credential Management**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/m2srw3HGtarsGGhR/integrations/all/greenhouse-basic/greenhouse_2.png?fit=max&auto=format&n=m2srw3HGtarsGGhR&q=85&s=c97714eab9cec3143d3c73fd7e350a30" width="2203" height="1058" data-path="integrations/all/greenhouse-basic/greenhouse_2.png" />

2. Click **Create New API Key**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/m2srw3HGtarsGGhR/integrations/all/greenhouse-basic/greenhouse_3.png?fit=max&auto=format&n=m2srw3HGtarsGGhR&q=85&s=9ce82118f93adb5f62ca08ec6b6ced08" width="1697" height="690" data-path="integrations/all/greenhouse-basic/greenhouse_3.png" />

3. Make the following selections:
   * **API type**: `Job board`.
   * **Partner**: Select the name of the integration that requested the API Key. If the integration isn't listed, select unlisted vendor. If you're creating a custom integration, select custom.
   * **Description**: Give your API Key a descriptive name.
4. When finished, click **Manage permissions**, or click **Create** to generate the API Key and automatically assign it the appropriate permissions required by the integration.
5. After the key is created, click **Copy**. Paste the **API Key** in a secure location.
6. Click **I have stored the API Key** to finish generating your **API Key**

#### Step 3: Enter credentials in the Connect UI

Once you have both your **Board Token** and **API Key**:

1. Open the form where you need to authenticate with Greenhouse (Job Board API).
2. Enter your **Board Token** and **API Key** in the respective field.
3. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/m2srw3HGtarsGGhR/integrations/all/greenhouse-job-board/form.png?fit=max&auto=format&n=m2srw3HGtarsGGhR&q=85&s=4a26d250e565edeb365d3e63bc138a23" style={{maxWidth: "450px" }} width="500" height="701" data-path="integrations/all/greenhouse-job-board/form.png" />

You are now connected to Greenhouse (Job Board API).
