Skip to main content
ATS Integrations
Greenhouse

Greenhouse

Metaview integrates seamlessly with Greenhouse. This makes it possible for Metaview to automatically capture scheduled interviews in Greenhouse so we can provide AI-generated summaries.

Set up integration

1. Configure > Dev Center > API Credential Management

Go to the "API Credential Management" section of Greenhouse's Dev Center page. You can do this by either using this link, or by following the steps in the recordings below.

Note: If you don't see the Dev Center, follow the instructions provided by Greenhouse to get access to the Dev Center. Alternatively, you can ask someone with appropriate access to configure this integration.

API Credential Management - Watch Video

2. Generate new Harvest API Key

Once in the API Credential Management page, click the "Create New API Key" button. From the "Type" dropdown select "Harvest". In the "Partners" box, search for and select "Metaview". This should automatically name the key "Metaview Harvest API Key". Click "Manage Permissions".

Create New Credential - Watch Video

3. Copy the generated key

Copy the new key. You will only be able to see the key at this point, so you must copy it before proceeding.

4. Configure new key

The newly generated key should have the required permissions automatically set. Check that the key has the following permissions:

View list of permissions

Activity Feed:

  • GET: Retrieve Activity Feed

Applications:

  • GET: Retrieve Application

  • GET: List Applications

Candidates:

  • GET: Retrieve Candidate

  • GET: List Candidates

  • POST: Add Note

Close Reasons:

  • GET: Get close reasons

Demographic Data (Optional):

  • GET: List Demographic Questions

  • GET: Retrieve Demographic Question

  • GET: List Demographic Answer Options

  • GET: Retrieve Demographic Answer Option

  • GET: List Demographic Answer Options for Demographic Question

  • GET: List Demographic Answers

  • GET: Retrieve Demographic Answer

  • GET: List Demographic Answers for Application

Departments:

  • GET: Retrieve Department

  • GET: List Departments

Email Templates (Optional):

  • GET: Retrieve Email Template

  • GET: List Email Templates

EEOC (Optional):

  • GET: Retrieve EEOC Data for Application

  • GET: List EEOC

Job Openings:

  • GET: List Openings For a Job

Job Posts:

  • GET: List Job Posts

  • GET: Retrieve Job Post for Job

  • GET: List Job Posts for Job

Job Stages:

  • GET: Retrieve Job Stage

  • GET: List Job Stages

  • GET: List Job Stages for Job

Jobs:

  • GET: Retrieve Job

  • GET: List Jobs

  • GET: Get hiring team

Offices:

  • GET: Retrieve Office

  • GET: List Offices

Rejection Reasons:

  • GET: List Rejection Reasons

Scheduled Interviews:

  • GET: List Interviews for Application

  • GET: Retrieve Interview

  • GET: List Interviews

  • POST: Create Scheduled Interview

  • PATCH: Update Scheduled Interview

Scorecards:

  • GET: Retrieve Application's Scorecard

  • GET: List Scorecards for Application

  • GET: Retrieve Scorecard

  • GET: List Scorecards

Sources:

  • GET: List Sources

Tags (Optional):

  • GET: List tags applied to candidate

  • GET: List Candidate Tags

User Roles:

  • GET: List User Roles

Users:

  • GET: Retrieve User

  • GET: List Users

  • GET: List User Job Permissions

Once you've selected the permissions above, click "Update" at the bottom of the page. 

5. Share Greenhouse Harvest API Key with Metaview

Copy the API key, then navigate to https://my.metaview.app/settings/greenhouse. If you haven't previously signed in to Metaview you will be prompted to do so. Enter the API key into the corresponding field.

Before saving, you'll also need to sign into Greenhouse and copy the URL from the browser address bar (it will end in ".greenhouse.io"). Enter it into the corresponding field in the Metaview Greenhouse setup page.

After saving your changes, the integration process will start. This can take up to 48 hours to complete, and you will be emailed once the integration is successful.

Posting to Greenhouse

Sometimes Metaview will comment on a candidate’s profile in Greenhouse. Examples of why Metaview will do this include:

  • adding a URL to the conversation to the candidate’s page

  • posting the full AI Notes to the candidate’s profile

All comments in Greenhouse need to be added as a user. Metaview therefore needs to find a Greenhouse user with the required permission to add the comment. Metaview, by default, picks a Greenhouse whole-site admin, and posts as this user.

However, a better solution is to post as “Metaview”. To enable “posting as Metaview”, you need to create an account in Greenhouse with the email “metaview@<company-domain>” and make this user a full site admin. Then, Metaview will be able to use this "user" to write to the candidate’s profile in all contexts and the notes will appear as coming from "Metaview".

Features

Integrating your Greenhouse ATS to Metaview unlocks the following features:

  • directly from ATS

  • Employees sync

  • Ability to view your ATS scorecards from Metaview

  • Ability to post your notes and to Greenhouse with one click

  • Automatic enrichment of (e.g. candidate name, job title, stage, location)

  • Automatic addition of links to Metaview notes in Greenhouse

  • Provide to calls for users with Recruiter and Hiring Manager roles in ATS

When a call was scheduled through Greenhouse or was matched to data in Greenhouse, you will see the Greenhouse logo in Metaview. Click on the Greenhouse logo go to the matched entry in your ATS.

Click on the Scorecard icon (if available) to see the relevant Greenhouse scorecard for your call.

The scorecard will only be available if Metaview was able to match your call to an interview in Greenhouse and if that entry has a scorecard.

Troubleshooting

When a call was not scheduled through Greenhouse, Metaview will still attempt to match your calls scheduled by other means to relevant entries in your ATS. This can take up to 30 minutes if your call was not scheduled in advance.

If ATS data sync is not successful or if your scorecard does not appear automatically, the most common reasons why are:

  • Call or candidate is missing in the ATS

  • Duplicate calls or candidates in the ATS

  • Data mismatch between Metaview invite and information in ATS (e.g. wrong participants, missing participant, wrong candidate)

  • Insufficient information to match call or candidate (often occurs when using or options).

If you believe that a Metaview call was not matched or was incorrectly matched to your ATS data, please reach out to support@metaview.ai and provide as much data as possible for our team to properly investigate. Please provide specific examples and the relevant IDs (e.g. application ID, candidate ID) from your ATS.