Answer
In order to integrate Greenhouse with JOIN, you need a User ID, an API Token, and the subdomain of your Greenhouse career page.
To collect all the information required, please follow the step-by-step instructions below.
Integrating Greenhouse with JOIN only takes five simple steps. We summarized the process for you to keep it as simple as possible and added a slideshow at the bottom of this page to provide visual support for the Workflow in Greenhouse.
Step 1: Configure user setup permissions in Greenhouse
Before creating the necessary API Token, make sure you have "Site Admin" rights. This is also necessary for retrieving your User ID that will be required in JOIN later on.
You may also need to configure the User permissions in Greenhouse first.
If you do not own the required permissions, please refer to someone in your team who owns Site Admin rights and ask to assign Site Admin Permissions to you as well.
Step 2: Retrieve User ID in Greenhouse
Now that you received the required site admin rights, it's time to retrieve your user ID. This can be done in two simple steps:
The User ID needs to be added under "ATS Identifier" in your Dashboard later on.
Step 3: Create a Harvest API Key in Greenhouse
Next, you need to create an API-Key in Greenhouse. This is done with the following steps:
Your Harvest API Key for the Greenhouse integration in JOIN is ready to go!
Step 4: Create a Custom Candidate Field (Optional)
Do you want the original source (e.g., LinkedIn, Indeed) of a candidate to be displayed in Greenhouse? Follow these steps to create a custom candidate field as a secondary source:
Now, all the keys and information you need from Greenhouse are prepared and in the next step, you simply need to enable the integration within your JOIN dashboard.
Step 5: Add integration data to JOIN
Almost done! The last step is adding your user ID, API Key, Secondary Source, and your Subdomain to your JOIN recruiter dashboard:
Congratulations, you made it!
Need some visual support to integrate Greenhouse? Check out our handy slideshow: