Migrating Greenhouse to Harvest v3

Read as Markdown

Greenhouse is retiring the Harvest v1 and v2 APIs on 31 August 2026. Cronofy is moving to Harvest v3, which authenticates with OAuth credentials rather than a single API key. To keep your interviews syncing between Cronofy and Greenhouse, you need to create new Harvest v3 (OAuth) credentials in Greenhouse and add it to your Cronofy integration settings.

You need to be a Site Admin with developer permissions in Greenhouse, and a user with the “Owner” or “IT admin” role in Cronofy, to complete these steps.

Greenhouse setup #

Step 1 - Create the Harvest v3 credentials in Greenhouse.

In Greenhouse, press the Settings cog in the top right corner, then select Dev Center from the left menu and choose API Credentials Management.

Click Create New API Credentials.
API type: Harvest V3 (OAuth).
Partner: leave blank.
Description: Cronofy Integration.
Click Create.

Greenhouse generates a Client ID and a Client Secret. Copy both and store them safely: the Client Secret is shown only once, so keep it confidential.

Step 2 - Grant the required permissions.

On the credentials you just created, grant the following scopes. Cronofy needs all of them, as a missing scope causes the affected part of the integration to stop working without an obvious error.

harvest:applications:list
harvest:candidates:list
harvest:users:list
harvest:jobs:list
harvest:application_stages:list
harvest:job_interview_stages:list
harvest:job_interviews:list
harvest:interviews:list
harvest:interviews:create
harvest:interviews:update
harvest:interviews:destroy
harvest:interviewers:list
harvest:interview_kits:list
harvest:default_interviewers:list
harvest:notes:create

Save the credentials once every scope is granted.

Cronofy setup #

Step 3 - Add the credentials in Cronofy.

In Cronofy, select your Organizational Unit Settings, then choose the Integrations tab to open the Greenhouse integration. Enter the following under API Credentials and press Save:

Client ID: the Client ID from Greenhouse.
Client Secret: the Client Secret from Greenhouse.

When you save, Cronofy checks the credentials against Greenhouse straight away. If anything is wrong, for example a missing permission or an incorrect Client Secret, you see an error on the form and nothing is saved until it works.

Once your Harvest v3 credentials are saved, there is nothing else for you to do. Your existing integration will continue to work as before.

Contact Us #

If you require assistance with following these steps, please reach out to our support team at support@cronofy.com or click the support widget on this page.