Vetty delivers innovative, friction-free pre-hire and post-hire background checks for enterprises, staffing agencies, and startups using deep-learning bots. 

Greenhouse Recruiting's integration with Vetty allows you to deploy background checks directly from Greenhouse Recruiting. In this article, we will cover how to: 


Configure User Setup Permissions in Greenhouse Recruiting 

Contact a Greenhouse Recruiting 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 following permissions to your account:

  • Can manage ALL organization's API Credentials
  • Can manage and configure web hooks

Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon configure.png > 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 and configure web hooks and Can manage ALL organization's API Credentials so a check is in each checkbox. When finished, click Save.


Repeat these steps for all users who should have access to set up the integration. 


Create a Harvest API Key for the Greenhouse Recruiting / Vetty Integration 

To create a Harvest API key for the integration, click on the Configure icon configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel. 

From the Dev Center page, click API Credential Management


From the API Credential Management page, click Create New API Key to generate the API Key for Vetty. 


From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create


On the Manage API Key Permissions page, grant the following permissions to the Vetty Harvest API key: 

Activity Feed

  • GET: Retrieve Activity Feed


  • DELETE: Delete Application
  • GET: Retrieve Application
  • GET: List Applications
  • PATCH: Update Application
  • POST: Advance Application
  • POST: Move Application
  • POST: Reject Application
  • POST: Moves Application to Job
  • POST: Unreject Application


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

Job Posts

  • GET: List Job Posts
  • GET: Retrieve Job Post for Job

Job Stages

  • GET: Retrieve Job Stage
  • GET: List Job Stages
  • GET: List Job Stages for Job


  • GET: Retrieve Job
  • GET: List Jobs


  • GET: List Application's Offers
  • GET: Retrieve Application's Current Offer
  • GET: Retrieve Offer
  • GET: List Offers


  • GET: Retrieve Office
  • GET: List Offices


  • GET: Retrieve User
  • GET: List Users

When finished, click Update at the bottom of the page. 

Your Harvest API key for the Greenhouse Recruiting / Vetty integration is created and configured. Navigate to the newly created API Key. Click Copy, and send the key to your Vetty onboarding team so they can set up the integration.



Create the Vetty Web Hook

To create the Vetty web hook, you will need a few pieces of information provided to you by the Vetty team. If you do not have this information yet, email your Vetty account manager or email to request the web hook information. 

Once you have the web hook information from Vetty, click on the Configure icon configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel. From the Dev Center page, click Web Hooks


Click Web Hooks from the subsequent page. 


You will be directed to a page where you can create a new web hook. From this Create A New Web Hook page, provide the following details: 

  • Name: We suggest Vetty
  • When: Be sure to select the correct action so the web hooks fires at the appropriate event in Greenhouse Recruiting [Candidate has changed stage]
  • Endpoint URL: Enter the URL provided to you by the Vetty team
  • Secret key: Create a secret key and provide the secret key to your Vetty account manager
  • Error recipient email: Enter the email address of the user who should be notified in case of an error


Click Create Web hook

That is it! Your Greenhouse Recruiting account and Vetty account can now talk to each other. These settings dictate execution of the Vetty web hook once the end user transitions the candidate into an appropriate application stage for a given job.


Provide Information to Vetty

If you have not done so already, provide your Harvest API key to your Vetty account manager, or to In addition to sharing your Harvest API key, tell the Vetty team at which job stage you would like the background check to kick off. 

Once this information has been provided to the Vetty team, your account manager will confirm receipt and will proceed with linking the accounts. Once Vetty confirms the accounts have been linked, a background check will be initiated when a candidate is moved into the background check stage in your Greenhouse Recruiting account. Your integration is complete! 


Deploy Background Checks and Review Background Check Statuses

When a candidate is moved to the selected background check stage in Greenhouse Recruiting, an order will be triggered to the Vetty system. After the background check is completed within the Vetty system, details about the background check and status can be viewed from the candidate's profile by clicking the Private tab. 


To review the background check report, click the URL under the Report field, sign into your Vetty account, and review.