Prerequisites
Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work. If you are already an administrator you likely already have these permissions.
Greenhouse user permissions required:
Developer Permissions
Manage ALL organization's API Credentials
User-Specific Permissions
Manage CRM (Only if candidate source writing is enabled)
Your Greenhouse admin can grant you the appropriate permissions.
Getting Started
Log in to Greenhouse, then click on the cog in the top right corner:
Go to "Dev Center" in the left menu:
In order to be able to complete the setup process, you should be able to see the "API Credential Management" item:
If you can not see this item, ask your Greenhouse account admin to take over the setup process, or to grant your user the "Manage ALL organization's API Credentials" permission. Without this permission, the setup process can not be completed.
Who is your Greenhouse account Administrator?
Go to the main Greenhouse dashboard.
Click on "Email Your In-House Contacts" under "Helpful Links":
Generate your API credentials
Log into your Greenhouse account and click on the cog in the top right corner:
Go to the "Dev Center":
Click on "API Credential Management":
Click on "Create New Api Key":
Enter the following details:
API Type: Harvest
Partner: Custom
Description: *Your Integration Name* (Preferably the value you copied earlier)
Copy your created API key and the paste the value into the connection flow:
Next, under "Manage permissions", select all the required permissions under Harvest V1.
You can find all the required permissions listed in the connection flow:
The list of permissions here is only an example. Please check the full listed permissions in the connection flow. Ensure that you scroll down and add all permissions from the list in Endorsed.
Once you filled in all the required permissions in Greenhouse, press "Save".After confirming the connection, you will be prompted to also set up Webhooks. For this, from the "Dev Center", navigate to "Webhooks" > "Webhooks"
There, enter the values as provided to you by the connection flow.
Keep in mind that you will have to fill out this form multiple times, once for every event type requested by the flow.
Tip: Greenhouse might not show the newly added Webhook in the list right after saving. Only after reloading the page next time will it show up. However don't worry, it is still saved.