Partner integrations, developers, and HRIS platforms use Greenhouse APIs to import and update jobs, offices, departments, and users. We recommend creating an Integration System User (ISU) to authenticate your API requests. Rather than requiring a specific user at your organization to authenticate the request, 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 API needs.
Additionally, the ISU will appear in all audit logs and reports, eliminating confusion about who performed a specific action.
Create an ISU in Greenhouse Recruiting
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.
Under the Set permissions section, click Site Admin, and grant the ISU all Site Admin user-specific permissions. Click Save when finished.
Once the ISU is created, locate the ISU in your users list (Configure > Users) and edit the user to set the name to
When finished, click Save.