Greenhouse Setup Guide

Follow our setup guide to connect Greenhouse to Fivetran.

Prerequisites

To connect Greenhouse to Fivetran, you need:

• A Greenhouse account with an active subscription.
• An account with owner/admin privileges.

IMPORTANT: Only use an HTTPS URL with TLS version 1.2 or above.

Setup instructions

Find webhook URL

In the connector setup form, find the automatically-generated webhook URL and make a note of it. You will need to register the URL in Greenhouse.

Find API Key

1. Log in to your Greenhouse account.

2. Click the Settings option.

   

3. Click Dev Center and then click API Credential Management.

   

4. Click Create New API Key.

   

   NOTE: You can also use an existing Harvest API key. Click Copy to make a note of it. Either skip to Step 3 to change its permissions if required, or proceed to Step 4 if it has sufficient permissions.

5. In the Create new credential window, enter a Description for the API key.

6. In the Type drop-down menu, select Harvest, and then click Manage Permissions.

   

   NOTE: Fivetran only supports the Harvest API.

7. Click Copy to make a note of your API Key. You will need it to configure Fivetran.

   

8. Click Close.

9. Give the key access to the Candidates endpoint.

   NOTE: You must have access to the Candidates object.

   

10. (Optional) Give the key access to the Demographic Data endpoint to sync demographic data.

    NOTE: You must be on a Greenhouse Expert plan to have access to the Demographic Data object.

11. Give the key access to other endpoints of your choice and then click Save.

    

NOTE: If you change the API key permissions after configuring the connector, then you need to reload the schema from your connector dashboard. You may observe sync errors or data integrity problems if you don't reload the schema.

(Optional) Change permissions for existing API key

1. In the Dev Center, click the pencil icon in the relevant row of the API key list.

   

2. Give the key access to endpoints of your choice.

3. Click Save.

Finish Fivetran configuration

1. In the connector setup form, enter the Destination schema name of your choice.

2. Enter the API key you found Step 2.

3. Click Save & Test.

Create webhooks

1. Return to the Dev Center.

2. Click Web Hooks and then click Web Hooks.

   

3. In the Create a new Webhook window, enter a name for your webhook.

4. In the When drop-down menu, select the event type you want to capture.

   

5. Enter the Endpoint URL from Step 1.

6. Enter the Secret key from Step 2.

7. Click Create Web hook.

8. Use the above steps to create the following event webhooks (with the same endpoint URL and secret key):

   • APPLICATION UPDATED
   • CANDIDATE HIRED
   • CANDIDATE REJECTED
   • CANDIDATE STAGE CHANGES
   • CANDIDATE UNHIRED
   • CANDIDATE UNREJECTED
   • DELETE APPLICATION
   • DELETE CANDIDATE
   • DEPARTMENT DELETED
   • INTERVIEW DELETED
   • JOB CREATED
   • JOB DELETED
   • JOB INTERVIEW STAGE DELETED
   • JOB POST DELETED
   • JOB UPDATED
   • MERGED CANDIDATE
   • NEW CANDIDATE APPLICATION
   • OFFER CREATED
   • OFFER DELETED
   • OFFER UPDATED
   • OFFICE DELETED
   • SCORECARD DELETED

Fivetran will take it from here and sync your Greenhouse data.

Related articles

description Connector Overview

account_tree Schema Information

assignment Release Notes

settings API Connector Configuration

home Documentation Home