Create a Greenhouse Recruiting ISU for custom integrations

If your organization is creating a custom integration using the Harvest API that will be creating or updating any data in Greenhouse Recruiting, you can create an Integration System User (ISU) to authenticate the Harvest API requests that the integration will perform.

Rather than requiring a specific user to authenticate the request (which would cause errors if the user loses permissions or cannot access Greenhouse Recruiting), creating an ISU allows you to create a solid infrastructure for your integration needs. Additionally, this ISU will appear in all audit logs, eliminating confusion about who performed a specific action.

Review the sections below for more information:

Create an ISU in Greenhouse Recruiting

To create an ISU in Greenhouse Recruiting, click the Configure icon Configure.png and then select Users on the left-hand panel.


Click + New Users on the subsequent page.


Enter an email address to be associated with the Integration System User.

Under the Set permissions section, click Site Admin, and grant the ISU all Site Admin user-specific permissions. Click Save when finished.

Note: The ISU user’s email address should not be associated with a real user. This does not have to be an email address with a real inbox (the user is not required to login to Greenhouse Recruiting), but the email address should use your company’s domain.


Once the ISU is created, locate the ISU in your users list and edit the user page to set the name to {integration_name} ISU. Click Save at the bottom of the page when finished.


Additional resources