How can we help you?

Woven

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.