Skip to main content

Connecting Greenhouse & Juro

Integrate Juro with Greenhouse to make your hiring processes easier and more efficient.

Written by Sharen Gill

šŸ’” NOTE: Juro's Greenhouse integration is organisation-wide.​ Only Juro Org Admins can connect and manage your organization's integrations.
​
​They can connect multiple Juro workspaces to a single Greenhouse environment, and the API Key you use stays the same for all workspaces.

Understanding required permissions šŸ”—


To enable the Juro integration in Greenhouse, users must have the following developer permissions.

  • Can manage ALL of the organization’s API Credentials

  • Can manage and configure webhooks

To map Greenhouse recruiting fields, only Site Admins or a Job Admin with the "who can manage custom fields" permission can map Greenhouse recruiting fields.


You can read more about user-specific permissions here.

Read more about Greenhouse developer permissions and how they work here

Managing 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 you set your user permissions, it's time to give Juro the access it needs to communicate with your Greenhouse instance.

Connecting Greenhouse in Juro integration šŸš€


Juro's Greenhouse integration uses an OAuth connection. Org Admins can activate it in the Connectors portal of the relevant Juro Workspace.

šŸ’”NOTE: We recommend using a service account for this action:

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. Confirm the permissions and log in to Greenhouse to complete the connection process.

Once this is complete, Greenhouse Recruiting automatically grants the required permissions.

Step 3ļøāƒ£ Creating trigger events for contract creation 🪤


Juro manages webhooks on your behalf, so you can select the events that will trigger contract creation (wherever possible, these shouldn't overlap).

Configuring Juro custom fields in Greenhouse


You must now set up Greenhouse's Custom fields to:

  • allow template selection from Greenhouse

  • retrieve the generated contract URL and status and pass these back to the relevant record.

1. Back in the Configure menu of Greenhouse, select Custom Options and then Offers.

2. Create a field dropdown for template selection.

  • Click Add field

  • Enter Juro Template Name (these exact three words) as the field name (this is not case-sensitive and can be: 'Juro Template Name', 'Juro template name', or 'JURO TEMPLATE NAME')

  • In the Type field, select Single select

  • In the Options field, add the template names from Juro. Make sure to insert each template name on a new line and that they are a character-for-character match to the name of the template in Juro, including capitalisation and spacing. The Templates don't need to appear in the same order as they do on Juro.

3. Create a field that will pass through the Juro contract status. To do this:

  • Click Add field

  • Enter Juro Status into the Name field (this is not case-sensitive and can be: 'Juro Status', 'Juro status', or 'JURO STATUS')

  • In the Type field, select Short textbox

  • Click Save

4. Create a field that will pass the Juro contract URL. To do this:

  • Click Add field

  • Enter Juro Contract Link into Field name (this is not case-sensitive and can be: Juro Contract Link, Juro contract link, or JURO CONTRACT LINK)

  • In the Type field, select URL

  • Click Save.

(Optional) The draft link lets you preview the document and is accessible by all external users, even if they don't have a Juro profile. To create a field that passes through the Juro draft link, replace step 2 of this flow with:

  • Enter Juro Draft Link into ā€œFieldā€ (this is not case-sensitive and can be: Juro Draft Link, Juro draft link, or JURO DRAFT LINK)

Mapping Juro smartfields to Greenhouse fields šŸ—ŗļø


To map Greenhouse fields to your Juro smartfields:

1. Unpublish your Juro template and open the Smartfields sidebar.

3. Click the 3 dots to the right of SYSTEM SMARTFIELDS and select Edit Greenhouse mapping.

šŸ’” NOTE: This option shows for members for whom self-serve mapping has been enabled. This access isn't granted by default, so to request access for additional members, please reach out to 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.

What happens next? 🧐


Now that you've configured the integration and mapped fields to Juro templates, a new contract will generate in Juro when a user selects the trigger event in your Greenhouse webhook.

Once the contract is fully signed, Juro will upload it to the relevant candidate's page in Greenhouse.
​
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 šŸš€

Did this answer your question?