💡 NOTE: Multiple workspaces can be connected to one Greenhouse environment. The API Key stays the same for all workspaces, so you just need to create new webhooks for each workspace (See Step 3 below).
To connect the integration 🔗
To enable the Juro integration in Greenhouse, users must have the below developer permissions. |
|
You can read more about Greenhouse developer permissions and how they work here. |
To map Greenhouse recruiting fields 🗾
Additionally, users must be a Site Admin or a Job Admin with the "who can manage custom fields" permission to map Greenhouse recruiting fields.
You can read more about user-specific permissions here.
To manage candidates and offers ✅
If a contract is created when a candidate is marked as hired, a user must be able to manage offers and mark candidates as hired. They need to be either:
a Site Admin with User-Specific Permission of "Can see private notes, salary info, manage offers, and approve jobs/offers", or,
a Job Admin with a level that includes the permission stripe of "Can view and edit offers and approve/request approval on offers" and "advance candidates/prospects"
Once your user permissions have been set, it's time to give Juro the access it needs to communicate with your Greenhouse instance.
Step 2️⃣ : Connecting Greenhouse 🍏 and Juro 🚀
Juro's Greenhouse integration uses an OAuth connection, so an Org Admin can activate the connection from the Connectors portal in Juro itself.
Greenhouse Recruiting will grant the required permissions automatically.
To do this:
1. Go to the Connectors portal and click the Greenhouse panel |
|
💡 NOTE: If this says Get in Touch, please contact Juro's Support Team using the Intercom button in the right-hand corner of this page to enable the integration. |
2. Paste your Greenhouse API key into the GREENHOUSE HARVEST API field in Juro. |
|
Once you've reviewed the permissions, you can log into Greenhouse to complete the connection process.
Step 3️⃣ Creating a Greenhouse event to trigger contract creation 🚀
1. Go to Webhooks in the Greenhouse Dev Center and create a Webhook that Juro will use to trigger contract creation. |
|
|
Now it's time to configure your Juro custom fields and map your Juro smartfields to your Greenhouse fields.
Step 4️⃣ Configuring Juro custom fields in Greenhouse 🏗️
To configure custom fields in Greenhouse that will aid template selection and pass through the contract URL and contract status:
1. Back in the Configure menu of Greenhouse, select Custom Options and then Offers. |
|
2. Create a field dropdown for template selection. To do this: |
|
|
|
|
|
|
|
|
|
|
3. Create a field that will pass through the Juro contract status. To do this: |
|
|
|
|
|
|
|
4. Create a field that will pass the Juro contract URL. To do this: |
|
|
|
|
|
|
|
5. (Optional) A draft link can be used to preview the document and is accessible by users even if they don't have a Juro profile. To create a field that will pass through the Juro draft link: |
|
|
|
|
|
|
|
You have now set up all the custom fields! This will allow Juro to pass data through to Greenhouse.
Step 5️⃣ Mapping Juro smartfields to Greenhouse fields 🗺️
To map Greenhouse fields to your Juro smartfields:
1. Open the template in Juro and, if published, click Unpublish. |
|
2. In the Actions bar, open the Smartfields tab. |
|
3. Click the 3 dots to the right of SYSTEM SMARTFIELDS. |
|
💡 NOTE: These 3 dots will only show for members for whom self-serve mapping has been requested/enabled. This access is not granted by default, so whenever you'd like to request access for additional members, please contact the Juro Support Team. |
4. Select the relevant Greenhouse field from the dropdown menu to map each Juro smartfield. Once you're finished, click Save and republish your template. |
|
The integration and mapping are complete! If you have any issues accessing fields within the dropdown, please cross-check the API permissions.
What happens now? 🧐
Now that you've configured the integration and mapped fields to Juro templates, a new contract will be automatically created in Juro from the selected template when the relevant event is selected on your Greenhouse webhook.
Once the contract has been fully signed, it will be uploaded to the relevant Greenhouse candidate's page.
If you face any issues, our dedicated Greenhouse troubleshooting article can help resolve some of the most common errors you may encounter when using Greenhouse with Juro.
💁♀️ As always, our Support Team is happy to help you with anything further if needed. Start a chat with us right here by clicking the Intercom button in the bottom-right-hand corner of this page.
Alternatively, you can email us at support@juro.com 🚀