Greenhouse Harvest v3 Migration Guide
Last updated: June 4, 2026
Greenhouse is moving from Harvest API v1 and v2 authentication to Harvest v3 API, which uses OAuth 2.0 for enhanced security. To ensure uninterrupted access to the HackerRank–Greenhouse integration, you will need to connect your Greenhouse account to the Harvest v3 API before August 28, 2026.
HackerRank understands that changes to integrations can require additional effort from recruiting and admin teams, especially when they affect critical hiring workflows. HackerRank is working closely with Greenhouse to make this transition as smooth as possible and to support customers through each step of the migration.
Migrating to Harvest v3
The migration process consists of two steps:
Step 1: Connect your Greenhouse account to Harvest v3 API
This step establishes the new connection and prepares your account for migration.
Log in to your HackerRank account using your company admin credentials.
Go to Settings > Integrations > Greenhouse > Connect, or open the Greenhouse integration page directly.
In the Connect to Greenhouse Harvest v3 API section, click Connect.
Log in to your Greenhouse account as prompted. Once you are logged in to Greenhouse, you will be redirected to HackerRank to complete the authorization process.
Review the permissions requested by HackerRank and click Authorize.
After you complete the authorization, a confirmation page appears displaying the status Connected.
Click Close tab to return to the Greenhouse integration page in HackerRank.
Verify that the Connect to Greenhouse Harvest v3 API section displays Connected.
Note: You do not need to update the existing Harvest API Token or Greenhouse User ID fields during the migration.
Step 2: HackerRank completes the backend migration
After you connect your Greenhouse account to Harvest v3 API, the HackerRank team verifies the new connection and performs the backend migration. The HackerRank team will guide you through this process and notify you when the migration is complete.
Frequently Asked Questions (FAQs)
The FAQs below answer common questions about the Greenhouse Harvest v3 API migration.
Why do I need to migrate?
Greenhouse will deprecate Harvest API v1 and v2 on August 31, 2026. After that date, integrations that continue to use those versions will no longer function. HackerRank will proactively reach out to migrate all affected customers before the deprecation.
Does this change affect both tests and interviews?
Yes. A single OAuth connection supports both Screen and Interview. You do not need to complete separate setup steps for each product.
Do I need to update the existing Harvest API Token or Greenhouse User ID?
You do not need to update your existing Harvest API Token or Greenhouse User ID.
The only action required is to complete the one-time OAuth connection from the Greenhouse integration settings page in HackerRank. This connection prepares your account for the Harvest v3 migration.
Harvest v3 does not use user impersonation. Instead, Greenhouse attributes integration actions to the Greenhouse user who authorizes the OAuth connection. HackerRank recommends that a Greenhouse administrator or authorized user in your organization completes the authorization.
Can I use Harvest v1/v2 and Harvest v3 simultaneously during the testing period?
HackerRank does not support running Harvest v1/v2 and Harvest v3 simultaneously for the Greenhouse integration. Running both versions simultaneously can create duplicate integration traffic, which may result in duplicate updates or other unexpected behavior in your Greenhouse account.
During the migration and testing period, your existing Harvest v1/v2 API keys will remain available as a rollback option. After HackerRank verifies that your Harvest v3 connection is working correctly, the HackerRank team will complete the backend migration and support you through the transition.
Will there be downtime during the migration?
HackerRank will verify the connections to Greenhouse and perform weekly batch migrations for the customers from Harvest v1/v2 to Harvest v3. The migration window is on Fridays between 3:00 PM and 4:00 PM Pacific Time. During this window, there may be a brief service interruption. The HackerRank Support team is available to help you through the migration process.