Permissions: Site Admin who can edit another user's advanced permissions

Product tier: Available for all subscription tiers

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 Configure icon on your navigation bar and then click Users.

The Configure page shows the Users button highlighted in marigold on the left of the page

Click + New Users on the next page.

The Users page shows the Add new users button highlighted in marigold on the center-right of the 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.

An example ISU is shown, with the user's first and last named edited to be Example Integration 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.