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.

Create an API Key in Greenhouse

  1. Navigate Create a new Harvest API key from your Greenhouse here.
  2. Click Create New API Key
  3. Select API Type = Harvest
  4. Choose Partner = Starred
  5. Enter a description, such as Starred integration.
  6. Click on Manage permissions
  1. In the next page, copy the API Key to store it somewhere before proceeding. If you lose it, you will have to create a new key. Confirm that you've stored it and you'll get to the next steps.

Adjust API Key permissions

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

Get the Endpoint URL and Secret Key from Starred

  1. From the navigation bar, click on Integrations.
  2. From the application overview, click on Connect under Greenhouse
  1. Enter de Harvest API key that you stored from Greenhouse and click Continue
  2. Starred will display an Endpoint URL and a Secret Key. Again, copy them and store them somewhere, hopefully in the same place where you stored the API Key.

Configure your webhooks in Greenhouse

To configure your webhooks, navigate to your Greenhouse webhooks settings or click here.

You need to create 4 webhooks in Greenhouse.

For this, you need the Endpoint URL and Secret key that you stored from Starred.

Create them one by one.

Candidate hired

  • Name the webhook
  • When: Candidate has been hired
  • Endpoint URL: copy the one you have
  • Secret key: copy the one you have
  • Create webhook

Candidate rejected

  • Name the webhook
  • When: Candidate or prospect rejected
  • Endpoint URL: copy the one you have
  • Secret key: copy the one you have
  • Create webhook

Offer created

  • Name the webhook
  • When: Offer created
  • Endpoint URL: copy the one you have
  • Secret key: copy the one you have
  • Create webhook

Candidate applied

  • Name the webhook
  • When: Candidate has submitted application
  • Endpoint URL: copy the one you have
  • Secret key: copy the one you have
  • Create webhook

Validate webhooks

  1. Go back to Starred Connect.
  2. Click on Validate webhooks: if all went well, a green pop up should let you know that the webhooks are correct.
  3. Click on Finish setup.

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