Connecting Greenhouse

In order to enable the Greenhouse/Starred integration, you need to have the proper permissions in Greenhouse. Your Greenhouse Administrator can help you with that.

Then, follow these steps to connect your Application.

In Greenhouse:

  1. Get a Harvest API key from your Greenhouse here. Click 'Create New API Key'.
    Enter any description and for Type select Harvest .
  2. Give the API Key the following permissions:
    Applications > Get: Retrieve Application
    Scheduled Interviews > Get: List Interviews for Application
    Departments > Get: List Departments
    Jobs > Get: Retrieve Jobs
    Job Posts > Get: List Job Posts
    Job Posts > Get: List Job Posts for Job
    Sources > Get: List Sources
    Users > Get: Retrieve User
    Custom Fields > Get: Get custom fields
    Candidates > Get: Retrieve Candidate

In Starred:

  1. Go Starred Connect's application overview
  2. Click Connect under the Greenhouse logo.
  1. Enter de Harvest API key that you got from step 1 and click Continue
  2. Copy the Endpoint URL and Secret Key.

Back to Greenhouse:

  1. Go to your Greenhouse web hooks settings here.
    We need to create 4 webhooks in Greenhouse:
    Candidate has been hired
    Candidate is rejected
    Offer created
    Candidate Applied
  2. Use the Endpoint URL and Secret key from Step 5 to configure the webhook. For the When setting select "Candidate has been hired". Click on Create Web Hook.
  3. Repeat step 7 but change the 'When' setting to use "Candidate or Prospect rejected".
  4. Repeat step 7 but change the 'When' setting to use "Offer created".
  5. Repeat step 7 but change the 'When' setting to use "Candidate has submitted application".
  6. Go back to Starred Connect. Click on Finish setup.

Starred Connect will now check if the webhooks are set up correctly.

..and that's it! Starred and Greenhouse are now integrated!