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:

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

Click the Configure icon  and select Users on the left side of the page. 

Screenshot-of-user-menu.png

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

Click the Add button under Job-Based Permissions

Click the Edit icon Icon_-_Edit.png next to the job you want the Woven user to access.

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

Screenshot-of-job-based-permissions-search.png

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 corner. Navigate to Dev Center on the left-hand panel.

Click API Credential Management on the Dev Center 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 next 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 next page, you’ll need to confirm permissions for your new API key.

Select all of the following options:

  • 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  

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.

Navigate to the webhook setup page. (Configure icon > Dev Center > Web Hooks > Web Hooks)

Enter the information below in the available fields to define the Send Candidates to Woven webhook.

Note: You'll need to create four separate webhooks for the Woven integration. Repeat these steps when you need to define additional webhooks.

 

Send candidates to Woven webhook information

  • Name this webhook: [Woven] Send intro
  • When: "Candidate has changed stage"
  • 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!

When you're finished, click Create Web hook

Greenhouse Recruiting 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:

Your new webhook will display at the bottom of the page.

Repeat this process for the Move a Candidate to a Different Job, Archive Candidate webhooks.

Note: Please notify Woven about each job in Greenhouse Recruiting that you will be sending to Woven. To make sure the integration works without issues, ensure the Woven user in your Greenhouse Recruiting account has access to those jobs. As part of the integration, Woven will need to update data on those jobs.

Move a Candidate to a Different Job webhook information

This webhook is necessary in order for Woven to correctly process candidates that you move from one Greenhouse Recruiting job to another.

Even if a candidate is moved to an additional listing for the same company job, Woven will need to update information in order to receive candidates for this new job. 

Before this webhook will function, make sure the following steps have been completed:

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

Note: If you don't tell Woven that a new job has been created, candidate assessments will be delayed.

Complete the following information for the 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!

Archive Candidate webhook information

If you’d like to automatically notify Woven when you reject candidates, you can set up a webhook to send the messages from Greenhouse Recruiting.

  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!

Hire Candidate webhook information

If you'd like to notify Woven when a candidate is hired, you can set up the below webhook. This action ensures that Woven's records are always in sync with Greenhouse Recruiting.

  1. Name this webhook: [Woven] Candidate hired
  2. When: "Candidate has been hired"
  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!

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.

Open the job that you want to integrate with Woven. (All Jobs > select job)

Click the Job Setup tab

Screenshot-of-job-setup-tab.png

Select the Interview Plan on the left side of the page and click the Add stage button. 

Screenshot-of-interview-plan-and-add-stage-buttons.png

Name your stage and click Add. Most users name their stage "Woven." 

Screenshot-of-naming-stage-window.png

Click and drag 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 Recruiting

Any time you move a candidate into your new Woven stage, Greenhouse Recruiting will send a message to Woven, which will automatically send the candidate a prep guide and work simulation link.

Woven will automatically add any updates to a candidate's Activity Feed, including the time the work simulation was sent and any follow-up reminders that were sent to the candidate. Each entry in the Activity Feed will also contain a link to a detailed analysis inside Woven.

Need Help?

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