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 > Users > Your Name.
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.
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 and select Dev Center on the left.
Select API Credential Management.
From the API Credential Management page, click Create New API Key to generate the API key for Compa.
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: Compa (optional)
- Description: Compa Harvest API Key
Click 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.
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.