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

Vetty

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.

Configure_-_Users.png

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.

Two_permissions.png

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. 

Dev_Center_-_API_Credential_Management.png

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

Create_new_API_key.png

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. 

Vetty.png

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

Activity Feed

  • GET: Retrieve Activity Feed
 mceclip0.png

Applications

  • 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
 mceclip1.png

Candidates

  • GET: Retrieve Candidate
  • GET: List Candidates
  • POST: Add Note
 mceclip2.png

Job Posts

  • GET: List Job Posts
  • GET: Retrieve Job Post for Job
 mceclip3.png

Job Stages

  • GET: Retrieve Job Stage
  • GET: List Job Stages
  • GET: List Job Stages for Job
 mceclip4.png

Jobs

  • GET: Retrieve Job
  • GET: List Jobs
 mceclip5.png

Offers

  • GET: List Application's Offers
  • GET: Retrieve Application's Current Offer
  • GET: Retrieve Offer
  • GET: List Offers
 mceclip6.png

Offices

  • GET: Retrieve Office
  • GET: List Offices
 mceclip7.png

Users

  • GET: Retrieve User
  • GET: List Users
 mceclip8.png

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.

mceclip9.png

 

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 support@vetty.co 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. 

Dev_Center_-_Web_Hooks.png

Click Web Hooks from the subsequent page. 

Web_Hooks_-_Web_Hooks.png

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

mceclip11.png

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 support@vetty.co. 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. 

mceclip12.png

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

mceclip13.png