Prerequisites
You must be a Pillar "Owner" in permission settings
The Zoom Integration for Greenhouse must be installed
You must be a Greenhouse Site Admin with Developer Permissions to manage ALL organization's API Credentials
How to Install
Please ensure that the prerequisites have been met
Go to the Greenhouse API Credential Management page
Note - if you cannot access this page, you need another Site Admin to grant you the developer permissions mentioned in the prerequisites
3. Click Create API Key. In the Description text box, type "Pillar API Key." Select "Harvest" for Type.
4. Select the following checkboxes:
- Applications
- Candidates
- Job Openings
- Job Posts
- Job Stages
- Jobs
- Scheduled Interviews
- Scorecards
- Users
- User Roles
5. After selecting the checkboxes, click Update at the bottom of the screen
6. You will be redirected back to the API Credential Management page. Find the newly created Pillar API Key and click the copy button.
7. Navigate back to Pillar
8. Click on your user avatar in the top right corner of the page, and click My Profile
9. Navigate to the Greenhouse page under Integrations on the left side of the page
Note - You must have "Owner"-level access in your Pillar Organization to access this page
10. Paste your API Key from step 7 into the Harvest API Key text box and click save.
11. On the first synchronization of Greenhouse to Pillar, the integration will create a new user in your Greenhouse Account with the email format: integrations+yourcompany@pillar.hr. This user will be assigned a Job Admin role to be able to read and write Interview Guide scorecards to Greenhouse. If your Greenhouse account does not have a User Role named "Standard" or "Basic" that is also a Job Admin, one must be created.
Usage
Once the integration is installed, it's time to select the roles you wish to sync with Pillar. Pillar will automatically join interviews for synced roles and scheduled via Greenhouse according to your organization's settings. There are two settings in Pillar for capturing interviews:
Import All - Pillar will join every interview scheduled through Greenhouse
Choose Jobs Individually - Specify which jobs Pillar should capture
By default, Pillar will use the Choose rolls individually setting when the integration is installed.
Once the correct roles are selected, they will populate into Pillar with a toggle next to each.
Note: toggling a role "on" activates Pillar's engagement with that role. This may include recording/transcribing interviews, as well as the activation of automated emails to candidates and interviewers, depending on your organization engagement.
Click this link for a guide to User Acceptance Testing (UAT) and the Pillar/Greenhouse integration
How to Uninstall the integration
Login to Pillar
Click your avatar in the top right of the page and click My Profile
Navigate to the Greenhouse Integration page
Under the Harvest API Key text box, click the Remove button