--- title: Juro slug: juro docTags: rl7p3XLQknqPB1UQ70cu_ createdAt: 2025-07-10T11:52:40.795Z --- This article covers how to set up Ashby's integration with Juro and how to configure and use Juro contract workflows from within Ashby. :::hint{type="warning"} **Prerequisites** Before following these steps, reach out to your Customer Success Manager (CSM) or the Startup Customer Success team to ensure you have access to set up the integration. ::: # Permissions & access The Juro integration is available on the Legacy Plus, Plus, and Enterprise plans: | Foundations | Legacy Plus | Plus | Enterprise | | ----------- | ----------- | ---- | ---------- | | ❌ | ✅ | ✅ | ✅ | :::hint{type="warning"} You must be an Organization Admin to set up this integration. Users must have the **Can add/edit candidates **permission to start workflows from the candidate profile. See [Manage Access Roles](docId\:be1Gtv2R0jGx_Do5mdNR_) for more information. ::: # Setting up the integration ## Creating the API key in Ashby 1. Navigate to **Admin > Integrations > [Integrations](https://app.ashbyhq.com/admin/integrations/marketplace)** and search for the [Juro integration tile](https://app.ashbyhq.com/admin/integrations/marketplace/juro). 2. Select the`+ Enable Juro` button in the top left of the Juro popover. You then see a screen where you need to enter some Juro configuration details. ![Ashby Admin Integrations page showing the Juro integration, with the Integrations menu option and “Enable Juro” button highlighted.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/Tlr3FZr9I_P7X5PkUlSzH_juro-ashby-2026-09-14-at-21821-pm.jpg) 3. Click the **Ashby API Key** box and type "Juro" to create an API key on the Ashby side. :::hint{type="info"} You don’t need to copy this API key for Juro to push updates to Ashby. However, this is your only opportunity to access it, so we recommend copying it and storing it securely. Disabling the API key will revoke Juro’s access. ::: ![](https://cdn.zappy.app/1a84d8ad98ffef3bf1233ec2eae5a698.png) ## Creating the API key in Juro to add to Ashby 1. Navigate to the [Juro integration settings page](https://app.juro.com/settings/integrations). 2. Select the `API box` in the **API and Webhooks** section. ![Juro API and Webhooks settings showing both the API and Webhooks connections as connected.](https://cdn.zappy.app/ab734f4e1856a71968eaeda622c4373d.png) 3. On the **API** page, click the green `Activate` button (if not already active), then copy the API key from the text box. You need this key in the next step. 4. Go back to the previous page and select the `Webhooks` box. 5. On the **Webhooks** page, click `+ Add New`. 6. Configure the webhook with the following details: 1. **Name:** Ashby 2. **URL:** https\://app.ashbyhq.com/api/juro\_webhook 3. **Security:** Signature 4. **Secret** (appears once you select Security: Signature): Paste your Juro API key here. 5. **Triggers:** Choose All 7. Click `Save webhook`. ![Juro webhook configuration for Ashby showing the webhook URL, Active status, Signature security with a secret, all triggers selected, and the “Save webhook” button.](https://cdn.zappy.app/fc7971874568522dcfecf4456e056e87.png) ## Adding the Juro API key to the integration settings in Ashby 1. Go back to the [Juro configuration page](https://app.ashbyhq.com/admin/integrations/marketplace/juro) in Ashby. 2. Select the **Juro API Key** box, paste your Juro API key (the same one you used in the webhook step), and click `Update`. :::hint{type="success"} The connection between Ashby and Juro is now complete! You can now import and kick off Juro contract workflows from Ashby. ::: # Configuring a workflow The video below provides an overview. You can also follow the steps in this article. ::loom{url="https://www.loom.com/embed/345f0b9a8dd64026bba4cb57077a7e20?sid=1abf6348-b533-421d-8945-df7fa3c4aba6"} To set up a workflow, navigate to **Admin > Integrations > [External Workflows](https://app.ashbyhq.com/admin/organizational-settings/external-workflows)**. Click `+ Add` and select Juro. ![Ashby External Workflows settings showing the Juro Offer Letter workflow configured to run when making an offer, with required candidate name and email fields.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/RF-P2ZsiyZn_TZbET53wF_external-workflows-ashby-2026-09-14-at-24015-pm.jpg) Each workflow has the following configuration fields: - **Name:** The title of the workflow being imported. - **Entry Point:** When and how the workflow can be added to the pipeline, either as an activity on an interview plan or when making an offer to a candidate. - **Field mapping: **The fields in Ashby from which information is pulled to send to Juro. - **Required?** Confirm whether the field is required. - **Hidden?** Choose whether to hide this field when the form is displayed in Ashby. ## Adding the workflow to an interview plan You can add activities to your interview plans within a job or job template in the **Admin** section of **Jobs**. When in the **Interview Plan** section of the role, click `Add Activity` for the stage in question, then select `External Workflow`. Select the workflow from the drop-down list and click `Add`. ![Ashby job Interview Plan with the Add Activity panel open and the “External Workflow” option highlighted under Integrations.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/Q4OqXP2OoBN2JYnhc2cAx_product-documentation-specialist-ashby-2026-09-14-at-22602-pm.jpg) Once the candidate moves to that stage in your pipeline, you see a prompt on their profile to start the Juro workflow. Click `Start Workflow`, then confirm the workflow and click `Start` on the pop-up. Complete any fields that need to be filled, then click `Submit` to start the workflow. Click `View Workflow` to view more details from Juro. ## Adding an external workflow to an offer If you have an external workflow set to be available when making an offer to a candidate, once the offer is created (and approved, if needed), you see the option to start the workflow within the offer details. ![Ashby Offer Process overview with the Workflow Summary section highlighted, showing that no workflow has been started and a “Start Workflow” button.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/398xuSLjq7zJ6zwTjc0ar_savannah-leeman-junior-designer-ashby-2026-09-14-at-24623-pm.jpg) After clicking `Start Workflow`, select the external workflow you want to use in the pop-up. Click `Start` to confirm the workflow. ![Start the Workflow dialog with “Juro Offer Letter” selected as the external workflow and a “Start” button to begin the workflow.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/oG7frYOBd-ZNXKmO7a6Y0_savannah-leeman-junior-designer-ashby-2026-09-14-at-24425-pm.jpg) The workflow fields are displayed alongside the offer details for you to complete, so you can ensure the information matches. Click `Submit` to send this information to Juro. ![Juro Offer Letter workflow form open alongside the Ashby Offer Process, showing candidate and offer fields to complete before starting the workflow.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/rYO5t5Uikc9K6gu0p5-6y_savannah-leeman-junior-designer-ashby-2026-09-14-at-24347-pm.jpg) Initially, the workflow shows as **Started** within the activity on the candidate's profile. The status changes to **Active** once information is received from Juro. You can view the workflow details within the offer information. Once the workflow is complete, Ashby marks the offer as accepted.