GAIA’s integration with Greenhouse Recruiting allows users to generate automated contracts for candidates based on pre-defined templates and the candidate data coming from Greenhouse.
Create a Harvest API key
To configure the integration, you’ll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the GAIA integration.
Credentials
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: GAIA or Unlisted Vendor
- Description: GAIA Harvest API Key
Permissions
Verify that the following permissions are selected for the GAIA integration:
- Candidates
- Get: Retrieve Candidate
- Get: List Candidates
- Applications
- Get: Retrieve Application
- Get: List Applications
- Custom Field Options
- Get: Custom field options
- Custom Fields
- Get: Get custom fields
- Jobs
- Get: Retrieve Job
- Get: List Jobs
- Get: Get hiring team
- Job Stages
- Get: List Job Stages for Job
- Get: Retrieve Job Stage
- Get: List Job Stages
- Offers
- Get: List Application's Offers
- Get: Retrieve Application's Current Offer
- Get: Retrieve Offer
- Get: List Offers
Users will get a link from GAIA to connect their Greenhouse account with the system, then they will need to follow the next steps:
- Confirm permissions
- Create API Key:
- Add Job Board Token:
On Greenhouse, you can find your Job Board URL by navigating to the Job Board settings. (Configure > Job Boards & Posts > Ellipsis icon next to job board > Edit Board Settings) and scroll to the URL field.
Click here for a more detailed walkthrough of how to locate your job board URL.
Copy the Job Board Token from the editable part of the URL (in the example picture: greenhousedemoboard) into the integration linking process:
- Done:
Reach out to your GAIA onboarding contact to finalize the integration on our side.
Use the GAIA integration
Once the integration is set up, navigate to ATS Import Settings on your GAIA company.
There, you can define the conditions in which a new contract will be created, depending on the section, contract template, and offer state.
Depending on the user’s internal process, usually you want to generate contracts either when they’re accepted (the candidate is marked as hired) or when an offer is created (draft).
Once this is saved, the next time the condition is fulfilled, contracts will be generated on GAIA. The data only flows from Greenhouse to GAIA, no updates are sent back to Greenhouse.
Additional resources
For additional information not covered here, reach out to mailto:support@gaia.law.