1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Candidate testing

Woven integration (legacy)

Note: An updated version of the Greenhouse Recruiting / Woven integration is available. For the most current version, click here.

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

Create a user for the Woven integration

When using the Woven integration, you'll need to create a new user account to be used to automatically post notes to the candidate profile. 

Create a new user and assign them Job Admin: Standard permissions on any jobs you want to integrate with Woven. If the user already exists, you can update their permissions.

Create a Harvest API key for the Woven integration

To configure the Greenhouse Recruiting / Woven integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Woven integration.

Credentials

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

  • API type: Harvest
  • Partner: Woven
  • Description: Woven Harvest API key

Permissions

Verify that the following permissions are selected for the Woven integration:

  • 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  

Provide your Harvest API key to Woven so they can finish setup.

Create webhooks

To integrate Woven with Greenhouse Recruiting, you'll need to create a webhook. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhooks.

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

Webhook 1: Send candidates to Woven

Note: 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.

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

Webhook 2: Move candidate to a different job

This webhook allows 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 you've informed the Woven Team of the new job and updated the permissions for your Woven user.

Webhook 3: Archive Candidate

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?: No

Webhook 4: Hire Candidate

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?: No

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.

Modify an interview plan and create a new custom stage named 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.

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.

Additional support

Contact help@woventeams.com for troubleshooting assistance regarding the integration.