Greenhouse integration

Contents


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

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!

Still need help? Contact Us Contact Us