Woven is the only 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. Your engineering team will save time and interview with more confidence that you’re speaking with complete engineers whose skills meet the mark.

Article table of contents

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 the required permissions for the Woven user

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

Choose which Greenhouse user you want to give Woven access to for the integration. You may choose to create a user specifically for Woven or an existing user. Click on the chosen 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 to give the Woven user permissions to.

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.

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 (optional)
  • Description: Woven Harvest API Key

When finished, click Manage Permissions to generate the Harvest API key and 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:


  • GET: Retrieve Candidate
  • GET: List Candidates
  • POST: Add Note

Job Stages

  • GET: List Job Stages
  • GET: List Job Stages for Job


  • GET: List Jobs


  • 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 they can set up the integration.

Enable Woven as the assessment partner in Greenhouse

Once the Greenhouse/Woven integration is enabled for your organization, you can get a Woven API key in the hiring dashboard. Visit Settings → ATS Integration and click the Generate button under Woven Integration API Key.

Once you have your API key, you will need to send it to Greenhouse to enable Woven for Assessments. Fill out the form at www.greenhouse.io/asksupport or click here to open a ticket. Ask Greenhouse to enable the Woven integration, but do not send them your API key yet.

The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key. The Greenhouse Support Team will then email you to confirm that your API key has been set up in your account and the integration is enabled.

Add the Woven stage to job’s interview plan

Once the Greenhouse/Woven Assessments integration is enabled for your organization, you will be able to add the Woven work simulation as an Interview stage.

To do this for an existing job, navigate to a job (All Jobs>Job Name) and click Job Setup from the Job navigation bar.

From the Job Setup page, navigate to Interview Plan on the left-hand panel. Click the Add Stage button at the top of the Interview Plan page.

From the Add Stage dialog box, select the Woven stage. When finished, click Add to apply the stage to the job's interview plan.

Configure the Woven stage

Once the stage has been added to the job's interview plan, click Edit Take Home Test. Use the provided drop-down menu to choose work simulations that you have previously created or requested from Woven.

Select the appropriate work sim and assign at least one Greenhouse user to review submitted work sims. When finished, click Save.

Note: Keep in mind that all configuration of the work simulation itself, as well as the email template, will need to be done by Woven.

Send and review the test

When candidates are moved into the Woven interview stage, Greenhouse will display a Send Test link.

Note: When you send a test from Greenhouse, the interview instructions are actually sent by Woven. Any email template configuration needs to happen in Woven.

The status of the work sim will be viewable in Greenhouse:

Once the candidate has submitted their test, the Interview Kit will contain a link to view the submitted test from Woven.

After you click on the Interview Kit on the candidate’s profile, you’ll be taken to a page where the URL is available to view the Woven recommendation.

Additional resources

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