# How to connect to Greenhouse with your API Key

To create a connection with Greenhouse, you have to complete 7 steps.

1. [Log into Greenhouse](#1-log-into-greenhouse)
2. [Open the Configure view](#2-open-the-configure-view)
3. [Click on the Dev Center link in the left menu](#3-click-on-the-dev-center-link-in-the-left-menu)
4. [Click API Credential Management](#4-click-api-credential-management)
5. [Create an API Key](#5-create-an-api-key)
6. [Configure the API key permissions](#6-configure-the-api-key-permissions)
7. [Vault Connection Setup](#7-vault-connection-setup)

## 1. Log into Greenhouse

Use the [login](https://app.greenhouse.io/users/sign_in) to access your Greenhouse account if you're not yet logged in. 

## 2. Open the Configure view

The next step is to click the Configure icon in the top right corner.

![Click Configure](https://res.cloudinary.com/apideck/image/upload/v1689960628/docs/connectors/greenhouse/configure-button.png)

## 3. Click on the Dev Center link in the left menu

![Click Dev Center](https://res.cloudinary.com/apideck/image/upload/v1689960894/docs/connectors/greenhouse/dev-center.png)

## 4. Click API Credential Management

![Click API Credential Management](https://res.cloudinary.com/apideck/image/upload/v1689961206/docs/connectors/greenhouse/api-credentials-management.png)

## 5. Create an API Key

![Create an API Key](https://res.cloudinary.com/apideck/image/upload/v1689961919/docs/connectors/greenhouse/create-api-key.png)

Select Harvest for the API Type and "Apideck" in the partner select. Provide a description for the API key and select Manage Permissions.

![Fill out the credential form](https://res.cloudinary.com/apideck/image/upload/v1760111218/docs/connectors/greenhouse/create-api-keyy.png)

Click the Copy button, and keep the API key stored for the next steps. Click "I have stored the API key" to continue.

![Copy API Key](https://res.cloudinary.com/apideck/image/upload/v1760112305/docs/connectors/greenhouse/copy-api-key.png)

## 6. Configure the API key permissions

Select the permissions required for the integration and click **save**.

![Configure the API key permissions](https://res.cloudinary.com/apideck/image/upload/v1760111218/docs/connectors/greenhouse/permissions.png)

## 7. Vault Connection Setup

Now that you've created an API key with access to your Greenhouse data, you can fill out your credentials and Job Board URL in Vault.

![Vault Greenhouse API key](https://res.cloudinary.com/apideck/image/upload/v1760111219/docs/connectors/greenhouse/vault-config.png)

Click **Save** after completing the form. If the API key is correctly configured, it will validate the connection and show a success message. 

To send write requests, select a user from the dropdown menu to specify on whose behalf the requests will be made. If no user is selected, only GET requests can be sent.

![Vault success message](https://res.cloudinary.com/apideck/image/upload/v1760111218/docs/connectors/greenhouse/write-operations-user.png)

Your Greenhouse account is now connected 🎉.