Recruitment Marketing Public
Greenhouse Harvest v3 is the current API version for the Recruitment Marketing (RM) integration. This version utilizes OAuth 2.0 to provide enhanced security and seamless data transfer between Greenhouse and PageUp.
Important:
Migration & Versioning:
- New Customers: Harvest v3 is enabled by default for all new integrations.
- Existing Customers: If you are using an older version, you must migrate to v3 before August 2026 to avoid service interruption.
- Requirement: An authorized user must grant permission via OAuth 2.0 to allow PageUp to make API calls on your behalf.
Creating or updating to a Greenhouse v3 integration
For existing customers, you will need to update your existing Greenhouse ATS integration within RM. New customers without an existing Greenhouse ATS integration should create a new v3 integration.
The full steps to create a Greenhouse integration are fully explained in the Greenhouse article.
You will need to select "v3" from the Harvest API Version drop-down menu (see screenshot below). Then on the OAuth scope version menu, select "v2 (adds custom location support)". The rest of the steps will be the same.
Before updating your existing integration to v3, it is advisable to take note of your existing Harvest API key in case it is necessary to revert back to the existing configuration.
Authorizing with Greenhouse
Once your new integration has been created, you will be able to see it in the list of ATS integrations in RM. For v3 integrations that are activated, there will be an extra icon in the Actions menu that you will need to use to connect with Greenhouse.
When you click on the plug icon, you will be redirected to Greenhouse to initiate the authorization process. You will see a list of scopes (endpoints) that you will be giving us access to. You will need to log in to Greenhouse by entering your email address and clicking on the button as per the screenshot below. We strongly recommend that the person performing this action has Admin privileges in Greenhouse.
Important:
The Greenhouse account performing this authorization process must have access to the Job Board(s) in Greenhouse.
If the person logging in is a Greenhouse Admin, you will see another screen with a checkbox asking to authorize using a service account, which is what we recommend, so tick that box and click on "Authorize".
Once the authorization process has succeeded, you will be redirected to the ATS integration list page in RM with a message of "Greenhouse ATS integration connected successfully". The actions menu will show a success tick, meaning the integration is fully connected to Greenhouse.
After this authorization process has been completed, you can start importing jobs and/or candidates regularly.
For further information, you can refer to this Greenhouse's support article on Harvest v3 integrations.
Comments
Article is closed for comments.