Integrations, custom integrations, and HRIS platforms use Greenhouse APIs to import and update jobs, offices, departments, users, and other data in Greenhouse Recruiting.
We recommend creating an integration system user (ISU) to associate with these integration requests.
What's an ISU?
An integration system user (ISU) is a Greenhouse Recruiting user profile created for the purpose of running an integration. Rather than requiring a specific user at your organization to authenticate an integration, which could cause downstream errors if the person loses permissions or cannot access Greenhouse Recruiting, an ISU allows you to create a solid infrastructure for your organization's integration needs.
Additionally, the ISU will appear in all audit logs and reports, eliminating confusion about who performed a specific action.
Create an ISU
To create an ISU in Greenhouse Recruiting, click the Configure icon on your navigation bar and then click Users.
Click + New Users on the next page.
Enter an email address to be associated with the ISU.
Note: The ISU's email address should not be associated with a real user. The email address doesn't need to have a working inbox, because the ISU isn't required to log in to Greenhouse Recruiting, but the email address should use your company's domain.
Under the Set permissions section, click Site Admin, and grant the ISU all Site Admin user-specific permissions.
When finished, click Save.
Once the ISU is created, locate the ISU in your users list (Configure > Users) and update the user's name to {integration_name} ISU.
When finished, click Save.
Your ISU is created and configured! You can locate the ISU's user ID to share with the integration if needed.