Woven

Woven works with you to identify the right assessment scenarios based on your hiring needs, then sends candidate submissions to expert engineers for review. Greenhouse Recruiting’s integration with Woven allows users to automatically send Woven assessments to candidates. When the assessments are set up, moving a candidate into the Woven stage in Greenhouse will automatically add the candidate to AirTable and send an introduction email to the candidate. 

 

In this article, we will cover how to:

 

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Scholars integration, you will need the developer permissions Can manage ALL organization’s API Credentials and Can manage and configure web hooks.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the necessary permissions to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure configure_new.png > Users > Your Name.

users.png

he user with Site Admin level permissions should navigate to the User-Specific Permissions panel on your user page and expand the Developer Permissions dropdown menu.

Select Can manage ALL organization’s API Credentials and Can manage and configure web hooks. When finished, click Save.

Harvest___web_hooks_perms.png

 

Create a Harvest API key for the Greenhouse/Woven Integration

To create a Harvest API key for the integration, click on the Configure icon configure_new.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

From the Dev Center page, click API Credential Management.

api_credential.png

From the API Credential Management page, click Create New API Key to generate the API key for Woven. Enter "Woven" for the description, and from the Type drop-down, select Harvest. Click Create.

Screen_Shot_2021-01-29_at_5.07.47_PM.png

On the Manage API Key Permissions page, select all of the following API permissions:

   
   
   
   
   
   

 

 

Create Web Hooks for the Greenhouse/Woven Integration

 

 

Use the Woven Integration

 

 

Get Further Help with the Woven Integration

 

 

   

What do customers get with a Greenhouse integration?

  • Assuming we have stages set up for the Woven assessment, moving a candidate to a Woven assessment stage will automatically add the candidate to Airtable and send the intro email.

  • A comment will be posted to the candidate's activity feed in Greenhouse when any of the following occur:

  • When the intro email with the "get started" link is sent

  • Any time we send a follow up reminder to the candidate (we send up to 3 reminders)

  • When the candidate completes the work simulation (if the customer is configured to receive completion notifications)

  • When the recommendation is shipped to the customer

Required permissions for the Woven user

The Woven user in your Greenhouse account will need to be a Job Admin: Standard for all roles that are using Woven.

  1. Click the Configuration gear in the navbar, then click on Users to access your user list.

  1. Click on the Woven user in the user list to make changes.

  2. Click the Add button under Job-Based Permissions

  1. Click the Edit button (pencil) next to the role you want to give the Woven user permissions to.

Note: You can use the search bar to find the role if you have a lot of roles.

  1. Select Job Admin: Standard

  1. Click Save

You should see a confirmation message at the top of the screen:

Grant Web hook permissions for the Woven user

If you'd like Woven to handle setting up Woven-specific webhooks for your Greenhouse account, you can give the Woven user permission by following these steps.

  1. Scroll to the bottom of the Edit User page and click on Developer permissions to expand the list of available permissions.

  1. Check the Can manage and configure webhooks box, then click Save

You should see a success message at the top of the page after saving.

Generate an API key

  1. Click the Configuration gear in the navbar

  2. Click Dev Center

  3. Click API Credential Management

  1. Click the Create New API Key button

  1. In the modal that opens, name the key as you prefer (we suggest "Woven API key") and select the Harvest option in the Type option list.

  1. Click the Create button

You'll see a success message at the top of the screen with the API key in the message. This key will be accessible in your account, so don't worry about copying it from here!

You'll need to set permissions for the API key, since Greenhouse does not give any permissions to API keys by default. See the below section for required permissions for integrating with Woven.

Required permissions for API key

All of the following options must be checked

  • Applications

  • GET: Retrieve Application

  • POST: Move Application (Same Job)

  • Candidates

  • GET: Retrieve Candidate

  • GET: List Candidates

  • POST: Add Note

  • Job Stages

  • GET: List Job Stages

  • Jobs

  • GET: List Jobs

  • Tags

  • POST: Add New Candidate Tags

  • DELETE: Remove Candidate Tags

  • Users

  • GET: List Users

Setting up webhooks (if Woven user does not have permission)

Click on the Configuration gear at the top of the page.

Click on Dev Center

Click on Web Hooks

Click on Web Hooks (again!)

Note: You'll need to create two separate webhooks.

Webhook to send candidates to Woven

  1. Name this webhook: [Woven] Send intro

  2. When: "Candidate has changed stage"

  3. Endpoint URL: https://admin.woventeams.com/webhooks/greenhouse_send_intro

  4. Secret key: use shared Slack channel name without the # (example: "woven-sample-company")

  5. Error recipient email: candidates+greenhouse_errors@woventeams.com

  6. Disabled?: Make sure the "No" radio button is selected!

  7. Click "Create Web hook" button

Greenhouse will send a test request to the webhook. If the webhook is configured correctly, you will see a success message at the top of the screen:

And you'll see your new webhook at the bottom of the page:

You'll follow the same basic steps to create a second webhook to be used when you reject candidates in Greenhouse.

Webhook to notify Woven of rejected candidates

  1. Name this webhook: [Woven] Candidate rejected

  2. When: "Candidate or Prospect rejected"

  3. Endpoint URL: https://admin.woventeams.com/webhooks/greenhouse_candidate_rejected

  4. Secret key: use shared Slack channel name without the # (example: "woven-sample-company")

  5. Error recipient email: candidates+greenhouse_errors@woventeams.com

  6. Disabled?: Make sure the "No" radio button is selected!

  7. Click "Create Web hook" button

Note:

If you get a Greenhouse error message instead of the expected success message:

1) Make sure that all configurations are correctly set.

2) If everything appears correct, please contact Woven, and we can troubleshoot together.