Greenhouse Recruiting Setup

Introduction

The Peoplelogic.ai Greenhouse integration allows you to use API Keys from Greenhouse to aggregate events from the organizations that the API Key has permission to access.  See What Events Does Peoplelogic.ai Process from Greenhouse for more information on the events that Peoplelogic.ai aggregates.

Prerequisites

You must have admin access to your Peoplelogic.ai account.  If you don't, point your administrator to this page to have them set up the integration.


You must generate an API Key for the account that you want Peoplelogic.ai to use and that key must have access to the Projects that you would like to aggregate events from.

To generate a personal access token for Greenhiouse visit https://app.greenhouse.io/configure/dev_center/credentials and create a new API Key.  Then click Manage Permissions on that API Key and make sure it has the following permissions:

GET: Retrieve Activity Feed
GET: Retrieve Candidate
GET: List Candidates
GET: Retrieve User
GET: List Users

Copy the API Key for use in the installation.

Configuration

Once you have your Greenhouse API Key, it's time to set up Peoplelogic.ai.  First, click the + icon near the top right of the Peoplelogic.ai interface and then click Add Integration.



Next, find the Greenhouse Integration (under General) and click Connect to Greenhouse Recruiting:



Next, you'll be shown a form to enter the details about your integration.  Follow the steps below to complete the setup.

Enter a meaningful and unique name
Enter your Greenhouse API Key into the API Key field.

When done, you should have something that looks like the following:



Click the green Save to complete the process and it should take you back to the screen showing your integration listed among the active integrations.

Testing

Peoplelogic.ai will start to aggregate the events during its next scheduled aggregation run and you should see events showing in the main dashboard timeline.  If you don't see any events and you know there has been activity in your accessible Greenhouse organizations, please contact Peoplelogic.ai Support.

Updated on: 17/11/2023