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, 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. 

Create an ISU in Greenhouse Recruiting

Click the Configure icon Configure.png and then select Users in the panel on the left. 

1.png

Click + New Users on the subsequent page. 

2.png

Enter an email address to be associated with the Integration System User. Under the Set permissions section, click Site Admin, then 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. 

Site_admin_all_user_specific_permissions.png

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.

Integration_name_ISU.png

Additional resources