Greenhouse integration
Contents
- What can you do with a Dado-Greenhouse integration?
- What data is exchanged between Dado and Greenhouse?
- How to set up the Greenhouse integration
What can you do with a Dado-Greenhouse integration?
The Dado <> Greenhouse integration allows you to use Greenhouse as a source for importing users and updating user data in Dado. For instance, you can import newly hired team members into Dado, including any relevant data which could be needed for your preboarding and onboarding process.
What data is exchanged between Dado and Greenhouse?
Greenhouse data accessible to Dado
Dado connects to Greenhouse via their Harvest API, using an API key generated by a particular Greenhouse user. Dado can in theory access any data in Greenhouse accessible to this user.
In practice, which data is synced to Dado is determined by you, when you set up Greenhouse as an import source and select which fields should be imported; and when you specify what status in Greenhouse should trigger an import into Dado.
Dado data accessible to Greenhouse
Dado does not sync data back to Greenhouse, so no data held in Dado would be exposed to Greenhouse.
Greenhouse Harvest API Permissions needed by Dado
- Applications
- Get: Retrieve Application
- Get: List Applications
- Candidates
- Get: Retrieve Candidate
- Get: List Candidates
- Custom Fields
- Get: Custom fields
- Custom Field Options
- Get: Custom field options
- Offers
- Get: List Application's Offers
- Get: Retrieve Application's Current Offer
- Get: Retrieve Offer
- Get: List Offers
How to set up the Greenhouse integration
Time required: 10 minutes
Pre-requisites: a Greenhouse account with Developer permissions to "Manage ALL organization's API credentials" (see these Greenhouse docs on how to grant this permissions level)
1. Create a new Harvest API Key
Follow the instructions in the Greenhouse Help Center to create a new Harvest API key.
Set the key up with the following configuration:
- Partner: Unlisted vendor
- Description: Dado
- Permissions:
- Applications
- Get: Retrieve Application
- Get: List Applications
- Candidates
- Get: Retrieve Candidate
- Get: List Candidates
- Offers
- Get: List Application's Offers
- Get: Retrieve Application's Current Offer
- Get: Retrieve Offer
- Get: List Offers
- Jobs
- Get: Retrieve Jobs
- Get: List Jobs
- Job posts
- Get: List Job Posts
- Applications
2. Add your API Key to Dado
- Go to Settings > Integrations
- Click on the Greenhouse card
- Enter your API key and click Save
3. Confirm which status should trigger a sync to Dado
By default, new hires will sync from Greenhouse to Dado when their offer status is moved to Offer Accepted.
If you need a different status to trigger data syncing to Dado, please let your Dado customer success manager know.
You're now ready to set up Greenhouse as an import source, and start importing data into Dado!