Woven is a technical assessment that uses real-world engineering scenarios to give you insight beyond code, including debugging, architecture, and communication. Real engineers will evaluate each candidate’s work and provide a detailed analysis, and the candidate gets individual feedback on how they did.

Greenhouse Recruiting’s integration with Woven allows you to seamlessly embed Woven's technical assessments in your interview plan. We’ll send the candidate a prep guide and a link to their work simulation, and then deliver the results to their Activity Feed once the candidate has finished. Your engineering team will save time and interview with more confidence that you’re speaking with complete engineers whose skills meet the mark.

 

In this article, we will cover how to:

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Woven] integration, you will need the developer permission Can manage ALL organization’s API Credentials.

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 API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon   > Users > Your Name).

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

Select Can manage ALL organization’s API Credentials so that a check is in the checkbox. When finished, click Save.

Repeat as necessary for any other user that should have access to set up the integration.

Set Required Permissions for the Woven User

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

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

 

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

Click the Add button under Job-Based Permissions

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

Tip: You can use the search bar to find the job if you have a lot of jobs.

Select Job Admin: Standard for the selected job.

Click Save.

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

 

 

Create a Harvest API Key for the Greenhouse/Woven Integration

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

 

From the Dev Center page, click API Credential Management.

 

 

From the API Credential Management page, click Create New API Key to generate the API key for Woven.

 

 

In the Create New Credential dialog box, make the following selections:

  • API Type: Harvest
  • Partner: Woven
  • Description: Woven Harvest API Key

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Woven.

 

 

 

 

In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Woven in the next step. Click I have stored the API Key once you have copied and saved the key.

 

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

 

 

On the subsequent page, you’ll need to confirm permissions for your new API key.

On the Manage API Key Permissions page, all of the following options must be checked:

  • Candidates
  • GET: Retrieve Candidate
  • GET: List Candidates
  • POST: Add Note
  • Job Stages
  • GET: List Job Stages
  • GET: List Job Stages for Job
  • Jobs
  • GET: List Jobs
  • Users
  • GET: List Users

If any of the permissions above are not checked, place a check in the box next to the appropriate permission. See the screenshot below as a reference.

 

Click Save when finished. Your Harvest API key for the Greenhouse/Woven integration is created and configured. Provide your Harvest API key to Woven so we can set up the integration.

 

Create Woven Webhooks

Before enabling the Greenhouse Recruiting / Woven integration, Greenhouse Recruiting will need a webhook set up.

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

Click on Dev Center

Click on Web Hooks

Click on Web Hooks (again!)

 

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
  4. Secret key: woven-your-company-name (example: "woven-greenhouse")
  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:

And that’s it! Your Greenhouse Recruiting account and Woven can now talk to each other.

Please notify us about every job in Greenhouse that you will be sending to Woven and ensure that the Woven user in your Greenhouse account has access to those job. We will need to update data on our end to ensure your integration works smoothly.

Move a Candidate to a Different Job

This webhook is necessary in order for Woven to correctly process candidates that you move from one Greenhouse job to another. Even if this is an additional listing for the same company job, Woven will need to update information in order to receive candidates for this new job. Please ensure the following:

  1. You informed Woven of the new job in Greenhouse
  2. You gave the Woven user in your Greenhouse account access to the new job

 

If Woven is unaware that there is a new job, candidate assessments will be delayed.

 

You'll follow the same basic steps as above to create this second webhook.

 

  • Name this webhook: [Woven] Candidate application
  • When: "Candidate has submitted application"
  • Endpoint URL: https://admin.woventeams.com/webhooks/greenhouse
  • Secret key: woven-your-company-name (example: "woven-greenhouse")
  • Error recipient email: candidates+greenhouse_errors@woventeams.com
  • Disabled?: Make sure the "No" radio button is selected!
  • Click "Create Web hook" button

Archive Candidate

If you’d like to automatically notify Woven when you reject candidates, you can set up a webhook to accomplish this.

 

You'll follow the same basic steps as above to create this second webhook.

 

  1. Name this webhook: [Woven] Candidate rejected
  2. When: "Candidate or Prospect rejected"
  3. Endpoint URL: https://admin.woventeams.com/webhooks/greenhouse
  4. Secret key: woven-your-company-name (example: "woven-greenhouse")
  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 want the full functionality of the Woven integration, you will have 3 separate webhooks after following the steps above.

Create a Woven Stage in Your Interview Plan

To integrate Woven with your Greenhouse account, you’ll need to create a Woven stage in the Interview Plan of each job where you want to send candidates to Woven.

 

  1. Click on the job that you want to use Woven for
  2. Click the Job Setup tab

 

  1. Click Interview Plan, then Click the “Add stage” button

 

  1. Name your new Woven stage (many folks simply use “Woven”) and click the Add button

 

  1. Place your new Woven stage where it fits best in your Interview Plan. You can use Woven as an initial screening tool for applicants, or it can be used after a first meeting to ensure that candidates have the skills to meet your engineering team’s needs.

How to use the Woven Integration with Greenhouse

Any time you move a candidate into your new Woven stage, we’ll automatically send the candidate a prep guide and work simulation link.

 

 

Woven will keep you up to date about each candidate’s status, including when we send them the work simulation, any follow ups we send to remind them to complete it, and we’ll deliver a summary and a link to our detailed analysis as a note to the candidate’s activity feed.

 

 

Additionally, if you set up the second webhook, whenever you reject a candidate, we’ll automatically be notified to stay in sync with your records.

Need Help?

Please contact help@woventeams.com for troubleshooting assistance regarding the integration.