Compa empowers recruiters to make every offer fair and competitive. The integration with Greenhouse makes it possible for Talent Acquisition teams to scale competitive pay decisions through real-time, data-driven offer intelligence.

Greenhouse Recruiting’s integration with Compa allows for application and compensation data to be structured, connected, and available to recruiters so they can navigate the offer process more efficiently.

Configure setup permissions in Greenhouse Recruiting

To configure the Greenhouse Recruiting / Compa integration, you’ll need the developer permission 'Can manage ALL organization’s API Credentials.'

To assign this permission, find a Greenhouse Recruiting user in your organization with Site Admin permission and the user-specific permission 'Can edit another user's advanced permissions' to update your account.

The Site Admin can update your permissions by navigating to your user page. They should click the Configure icon Configure icon > Users > Your Name.

Screenshot of Configure > Users

The Site Admin should scroll to the User-Specific Permissions panel on your user page and expand the Developer Permissions dropdown menu.

Select 'Can manage ALL organization’s API credentials' in the Developer Permissions section and click Save.

Screenshot of developer permission: Can manage ALL organization's API credentials

Create a Harvest API key for the Greenhouse Recruiting / Compa integration

Note: To generate an API key, you must have the developer permission 'Can manage ALL organization's API Credentials.'

Click on the Configure icon Configure icon and select Dev Center on the left.

Screenshot of Configure > Dev Center

Select API Credential Management.

Screenshot of Configure > Dev Center > API Credential Management

From the API Credential Management page, click Create New API Key to generate the API key for Compa.

Screenshot of API Credential Management > Create new API key

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: Compa (optional)
  • Description: Compa Harvest API Key

Click Manage Permissions.

Screenshot of create new API key > Manage Permissions

Click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Compa in the next step.

Screenshot of API key > I have stored the API key

Click I have stored the API Key once you have copied and saved the key.

Note: You won’t be able to view the API key after clicking I have stored the API Key. If you lose your API key or need to access it later, you’ll need to generate a new key and provide it to Compa.

Select the checkboxes next to each permission box to associate it with the API key.

Select all of the following permissions that are needed for the Compa integration:

  • Applications
  • Candidates
  • Tags
  • Users
  • EEOC
  • Offers
  • Departments
  • Custom locations
  • Jobs
  • Job stages
  • Job openings
  • Offices
  • Rejection reasons
  • User roles
  • Custom fields
  • Custom field options
  • Close reasons
  • Education
  • Approvals
  • Demographic data

When finished, click Save.

Your Harvest API key for the Greenhouse Recruiting / Compa integration is created and configured. Provide your Harvest API key to your Compa onboarding team so they can set up the integration.

Use the Compa integration with Greenhouse Recruiting

Compa stays in-sync with changes you make in Greenhouse automatically using the Harvest API and web hooks. When a recruiter needs to complete a step in Greenhouse, Compa deep links directly to the relevant page in Greenhouse.

As part of the integration, Compa deploys “Compa Bot” to automatically post updated notes in Greenhouse based on user activity in Compa and to deep link from Greenhouse to Compa. Compa Bot is a service user that Compa will create as part of the integration setup. Compa Bot writes in Greenhouse on behalf of Compa.

Additional resources

For support or information not covered here, reach out to zack@trycompa.com.