Harvest API v1 and v2 will be deprecated and unavailable after August 31, 2026. Please make sure that your existing custom integrations use the latest version of Harvest (v3) by this date and any new integrations are developed with the latest version of Harvest API.
Some integrations require Harvest API credentials to connect to your Greenhouse Recruiting account. Check out the integration documentation for information on a specific integration.
Create Harvest API credentials for an integration
Click the Configure icon on your navigation bar, then click Dev Center on the left.
Click API Credential Management.
Click Create new API credentials.
Make the following selections:
- API type: Choose Harvest or Harvest v3 (OAuth)
- Partner: Select the name of the integration that requested the API credential. If the integration isn't listed, select unlisted vendor. If you're creating a custom integration, select custom.
- Description: Give your API key a descriptive name.
When finished, click Manage permissions or View and store credentials (depending on which Harvest version you chose.)
After the the credential is created, click Copy, and paste the credentials in a secure location to provide to the integration later.
Click I have stored the client credentials.
Note:
- For Harvest v3, the client secret is shown only once. The client key remains visible.
- For Harvest v1/v2, the API key is shown only once and can't be viewed again after clicking I have stored the API key.
Next, confirm the permissions requested by the integration are assigned to your new API key. If any of the requested permissions are not assigned to the API key, assign them.
Note: Be aware that providing permission to your data is similar to assigning a user access to the data in-app. Learn more at Manage Harvest API credentials permissions.
When finished, click Save.
Provide the API key to your contact at the integration.