Prerequisites
Before getting started, please carefully read the following to make sure you fulfil all requirements for the integration to work:
- Greenhouse user permissions required:
- Developer Permissions
- Manage ALL organization's API Credentials
- Manage ALL organization's API Credentials
- User-Specific Permissions
-
Manage CRM (Only if candidate source writing is enabled)
-
Manage CRM (Only if candidate source writing is enabled)
- Developer Permissions
- Your Greenhouse admin can grant you the appropriate permissions.
- 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 credentials":
- Enter the following details:
- API Type: Harvest V3 (OAuth)
-
Description: *Your Integration Name*
- Click on "View and store credentials".
- Copy your created API key and the paste the value into the connection flow:
- Click on "I have stored the client credentials" once you've saved them in the connection flow.
- Next, under "Manage scopes", select all the required permissions under Harvest.
You can find all the required permissions listed in the connection flow:
The list of permissions here is only an example. Please check your own permissions in the connection flow.
Once you filled in all the required permissions in Greenhouse, press "Save".