Connect Greenhouse to Cronofy

Read as Markdown

Please follow the instructions below to grant Cronofy access to Greenhouse, so that interviews scheduled via Cronofy can be synced into Greenhouse.

Greenhouse is retiring the Harvest v1 and v2 APIs on 31 August 2026. Cronofy now connects to Greenhouse using Harvest v3 (OAuth) credentials. If you previously connected using a Harvest API key (v1), follow the steps below to create Harvest v3 credentials before the cut-off date to keep your interviews syncing.

Please note that 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 set up the integration.

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. Once you have stored them, click I have stored the credentials to reveal the scopes.

Step 2 - Set the permissions in Greenhouse.

Select the dropdown arrow under Harvest to open the list of scopes, then grant the following permissions and press Save.

- Application Stages
  - List Application Stages
- Applications
  - List Applications
- Candidates
  - List Candidates
- Default Interviewers
  - List Default Interviewers
- Interview Kits
  - List Interview Kits
- Interviewers
  - List Interviewers
- Interviews
  - Create Interview
  - Delete Interview
  - List Interviews
  - Update Interview
- Job Interview Stages
  - List Job Interview Stages
- Job Interviews
  - List Job Interviews
- Jobs
  - List Jobs
- Notes
  - Create Note
- Users
  - List Users

Cronofy needs all of them, as a missing scope causes the affected part of the integration to stop working without an obvious error.

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.

Now that you have successfully connected Greenhouse to Cronofy, take a look at how you can set up our full or partial automation.

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.