Introduction π
It can be frustrating to receive a Greenhouse error when you think everything is ready to go.
In this article, we'll look at how you can resolve some of the most common errors that you may encounter when using Greenhouse together with Juro. First, let's get a better idea of what these errors, and the individual fixes for them, are βοΈ
Common Errors π©οΈ
Below, we've compiled a table of the most common errors that we've seen our customers encounter when using our Greenhouse integration. Most of them can be resolved very quickly by following the guidance for relevant errors in the Resolution column.
Error | Resolution |
Template was not published |
|
Mandatory field was left empty |
|
Incorrect field input for a choice field. (Juro will specify which field and what value it was expecting vs what it received from Greenhouse) |
|
API permissions are inaccurate | This means that API permissions are not providing sufficient access to Juro:
|
The PDF did not pass back due to insufficient permissions | When a document is fully signed, Juro will pass the PDF back to the application. There are 2 reasons this may fail:
|
The contract owner in Juro is incorrect | To rectify this, you'll need to confirm:
|
Seeing errors in Juro π
Organisation Admins in Juro can view errors in each team's integration log, and see a detailed description of why the error has occurred.
To open your integration log in Juro:
Go to Settings for the relevant team
Select Integrations
Select the Greenhouse panel
Click Open Integrations log.
No errors shown π
If the contract did not create from Greenhouse and no errors are shown in the Juro integration log, we can troubleshoot further to find if the issue is with the API permissions, with the webhook or with the custom field:
Area to check | Resolution |
Step 1: Were you able to successfully complete the field mapping in the Juro template? | If yes: the API permissions are correct, you can proceed to Step 2.
If no: the API permissions are not allowing Juro to access fields and pull data through. Please reference Step 1 of our integration guide and ensure the correct permissions are selected. Once this has been completed, retry the offer creation from Greenhouse to trigger contract creation. |
Step 2: Was the webhook correctly set up in Greenhouse? |
If all of the above are correct, please proceed to Step 3. Otherwise, adjust the above and then retry creating the offer to trigger contract creation. |
Step 3: Could there be an issue with the custom field created for template selection? | In Greenhouse, checking Dev Centre > Custom Options > Offers and the field created for the Juro template selection. Scrolling to the bottom, does the immutable field key at the bottom of this page begin with "juro_template_name" (the ending of this is flexible)?
If it doesn't, please delete this field and recreate it with the label "Juro Template Name" as this will set the correct immutable field key that will allow Juro to reference this field and use it for template creation. |
πββοΈ 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 your query to support@juro.com π