# Guides Greenhouse overview page

## Setup

Before you can use Cronofy with Greenhouse you need to setup the integration and the automation triggers. You need to be a **Site** **Admin** with *developer* permissions in Greenhouse and a user with the “**owner**” role in Cronofy to set up the integration.

After that you can setup the scheduling triggers, that **automatically send a scheduler link to the right candidate and interviewers** via an email template, when you move a candidate to a different interview stage in Greenhouse.


## How do I setup my Greenhouse integration?

*Please note that you need to be a Site Admin with **[developer permissions](https://support.greenhouse.io/hc/en-us/articles/201122629)** in Greenhouse and a user with the “owner” role in Cronofy to set up the integration.*

**Step 1 - Create the API key in Greenhouse.**

In Greenhouse, press the “Settings” cog in the top right corner.
Select Dev Center from the left menu to choose API Credential Management.

Then select **Create New API Key** using the following settings:

1. API Type: Harvest

1. Partner: *Leave Blank*

1. Description: Cronofy Integration

1. Press **Create**

**Step 2 - Paste the API key in Cronofy.**

  5. In Cronofy, you would first need to select your **Organisational** **Unit** **Settings**, choose **Admin** and then the “**Integrations**” tab, to access Greenhouse integration.

Then paste the API key under the **“Harvest api key”** section in Integration Settings and press “Save”, as shown in the image below:

**Step 3 - Set the permissions in Greenhouse.**

6. In Greenhouse, select the following Permissions and press **Save**.

Now that you have successfully connected Greenhouse to Cronofy, take a look at how you can set up our [full](https://docs.cronofy.com/integrations/greenhouse/setting-up-greenhouse-triggers/) or [partial automation](https://docs.cronofy.com/integrations/greenhouse/setting-up-browser-extension-integration/).

## Setup my automations in Greenhouse

If you want to see how scheduling link automations work, you can visit the how-to article for Greenhouse. This article will deal only with setting the automations up.

First you will need to create a **webhook** and then the **scheduling** **trigger**.

## How to create a web-hook in Greenhouse?

If you want to see how scheduling link automations work, you can visit the how-to article for Greenhouse. This article will deal only with setting the automations up.

**Step 1 - Retrieve the Web Hook Settings in Cronofy.**

To enable the Scheduling Triggers, you will need to create a web hook in Greenhouse using the “Web Hook Settings” details in Cronofy.

In Cronofy, go to your Organizational Unit Settings and select Greenhouse in the “Integrations” tab. Then, under “Integration Settings” select Web Hook Settings and copy the **Secret Key**, **Username** and **Password** for later use.

Step 2 - Create the web hook in Greenhouse.

In Greenhouse Dev Centre, select Web Hooks to create a new Web Hook. Please fill out the required details:

1. Name: Cronofy Scheduling

1. When: Candidate Has Changed Stage

1. Endpoint URL: [https://app.cronofy.com/integrations_api/greenhouse_web_hooks](https://app.cronofy.com/integrations_api/greenhouse_web_hooks)

1. Secret Key: Obtain this from your Cronofy application

1. Error Recipient Email: Your IT Admin email address

1. Disabled?: No

1. Press **Advanced Settings**

1. Enter **Username** and **Password** obtained earlier from Cronofy

9. Press **Create Web Hook**. If this is unsuccessful check the log output for details.

You have now set up the integration between both systems, so you are ready to create Scheduling Triggers!