Greenhouse Harvest API V3 Integration

Last updated: May 15, 2026

ModernLoop now supports Greenhouse Harvest V3, bringing improved performance, stronger security, and a more consistent API structure to your integration.

This update is designed to be seamless, with no disruption to your current workflows, while unlocking important enhancements behind the scenes.

Why This Update is Happening

Greenhouse is requiring all customers and partners to migrate to Harvest API V3 and will be deprecating Harvest API V1/V2 (the current integration that uses an org-wide API key).

To ensure continued functionality of your ModernLoop + Greenhouse integration, setting up your team's Harvest V3 integrations will be required.

What Do I Need To Do?

IMPORTANT - Please complete these steps by July 7th, 2026 to avoid disruption to your Greenhouse integration.

Summary:

Set up your organization's Harvest V3 integration
- done once for your entire organization
- must be done by a Greenhouse Site Admin
Set up your personal Harvest V3 integration
- must be done by all schedulers and admins in your organization

Steps to set up the Harvest V3 integration

Step 1: Configure the Harvest V3 integration at the organization level

The organization-level integration must be set up with a Greenhouse user that has Site Admin permissions.

If you are not a Greenhouse Site Admin, please skip this step and continue to Step 2 for authorizing Harvest V3 at the individual level.

In ModernLoop, navigate to Organization settings → Organization → Integrations
Click Connect next to Greenhouse (Harvest V3 - OAuth)
Enter your email address and click Log in to Greenhouse
Log in to Greenhouse
Select Authorize using a service account, then click Authorize

If you do not see the Authorize using a service account checkbox, your Greenhouse user does not have Site Admin permissions and you won't be able to set up your organization's integration. You can still set up your personal integration.

After authorizing, you'll be redirected back to ModernLoop. If you encounter any errors when being redirected back to ModernLoop, please refer to the Common Errors section at the bottom of this article for remediation steps.

Step 2: Authorize the Greenhouse integration at the personal level

To ensure scheduling actions are correctly attributed to you in Greenhouse metrics, connect your personal account as well:

Navigate to Your account → Personal Preferences
Select the Integrations tab
Select Connect next to Greenhouse
Enter your email and click Log in to Greenhouse

If you see the "Authorize using a service account" checkbox, leave it UNCHECKED, then click Authorize. If you don't see the checkbox, you can simply proceed and click Authorize.

For Individual Greenhouse integrations, it's very important to leave the "Authorize using a service account" checkbox unchecked. Otherwise your personal account will not be connected to the integration you're creating.

After authorizing, you'll be redirected back to ModernLoop. If you encounter any errors when being redirected back to ModernLoop, please refer to the Common Errors section at the bottom of this article for remediation steps.

Permissions

These permissions are automatically applied when authorizing the integration. The list below is for reference only. Please reach out to the ModernLoop support team if you have any concerns about any of these permissions.

The following permissions are required for the ModernLoop integration:

List application stages
List applications
List attachments
List candidates
List default interviewers
List departments
List email templates
List interview kits
List interviewers
List interviews
List job hiring managers
List job interview stages
List job interviews
List job owners
List job post locations
List job posts
List jobs
List notes
List scorecards
List sources
List user emails
List user job permissions
List user roles
List users
Create applications
Create attachments
Create candidates
Create interviews
Create notes
Destroy interviews
Move applications
Update applications
Update candidates
Update interviews
Merge candidates

Frequently Asked Questions

Will there be any disruption or changes to my team's processes in ModernLoop or Greenhouse due to this migration?

There are no disruptions to your team's process in either platform. The only change that occurs is that upon setting up organization-level Harvest V3, ModernLoop will start syncing candidate preferred names from Greenhouse and display them in the platform.

Do I need to do anything with my original Greenhouse API Key integration?

Please DO NOT change or remove your original Greenhouse API Key as part of this migration process. We will remove this integration for you when it is safe to do so.

Can I set up my team's organization-level integration if I'm not a Greenhouse Site Admin?

No. Only Greenhouse Site Admins can set up their team's organization-level integration.

**Why am I not seeing the "Authorize using service account" checkbox while setting up my organization's V3 integration?**

If you do not see this checkbox, that means you do not have Site Admin permissions in Greenhouse and therefore cannot set up (or reconnect) your organization's V3 integration. Please have a Greenhouse user with Site Admin permissions do this instead.

If I use my account to set up our organization-level integration, will all scheduling actions appear as if they were performed by me?

No. Scheduling actions are always performed using the personal integration of the user taking the action. That’s why all schedulers and admins are required to set up their own personal integrations, so that actions are correctly attributed to the individual who performed them.

What happens if the person who originally connected the organization-level integration loses access or leaves the company?

This is why we require an organization-level integration tied to a Greenhouse service account. The Greenhouse service account is not tied to any individual user and has admin-level permissions. It’s used for all non-scheduling actions, ensuring the integration continues to function even if individual users lose access or leave the organization.

What is the Greenhouse service account, and how does it work?

The service account is a Greenhouse-created account, and its sole purpose is to own the authorization to ModernLoop. The service account is not tied to any individual user, has no username or password, does not appear in the Users list in Greenhouse, and is managed entirely internally by Greenhouse.

Do I need to create the service account myself before setup?

No. There is nothing separate that needs to be done for the service account. Checking the Authorize using a service account checkbox during the setup creates the service account for you.

Who needs to set up personal Harvest V3 integrations in ModernLoop?

All users with scheduler or admin roles in ModernLoop are strongly recommended to set up their personal Harvest V3 integration.

Users with the interviewer role do NOT have a personal Harvest V3 integration to set up.

**What is the impact if my team does not set up our organization-level Harvest V3 integration by July 7th?**

If your team's organization-level Harvest V3 integration is not set up by July 7th, we cannot guarantee that the ModernLoop integration with your Greenhouse instance will continue to work past the August 31 deadline.

**What is the impact if any individual person on my team does not set up their personal Harvest V3 integration by July 7th?**

If any individual user does not set up their personal Harvest V3 integration in ModernLoop by July 7th, they will no longer be attributed as the scheduler in Greenhouse for any schedules that were created through ModernLoop and will therefore impact their scheduling metrics.

Why is ModernLoop enforcing a deadline of July 7th for setting up the integration when Greenhouse is communicating a deadline of August 31?

Greenhouse will be shutting down the V1/V2 API on August 31. We are enforcing a deadline well before that in order to get ahead of the changes and reduce any risk of service disruption before the V1/V2 API is completely shut down.

How can I track which users in my organization have set up their personal Greenhouse V3 integration?

We provide a downloadable report that shows which users in your organization have and have not completed their personal Greenhouse V3 integration setup. Please navigate to Settings -> Downloads -> Greenhouse V3 Integration -> Download CSV

Common Errors Encountered During Integration Setup

The organization-level integration failed to authorize because it was not using a service account. In this case, the integration needs to be set up with a Greenhouse user with Site Admin permissions in order to see the checkbox, and the checkbox must be checked in order to set up the integration.

A personal integration was attempting to set up a service account integration, which is invalid. Service accounts are anonymous accounts and therefore cannot be used for personal Greenhouse integrations. Please try again without authorizing a service account.

The ModernLoop user setting up the personal integration does not match the user that logged into Greenhouse. You must use a Greenhouse user that has a matching email address with your directory user (including email aliases).