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
- Create a Harvest API Key for the Greenhouse Recruiting / Vetty Integration
- Create the Vetty Web Hook
- Provide Information to Vetty
- Deploy Background Checks and Review Background Check Statuses
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 > 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 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
|
![]() |
Applications
|
![]() |
Candidates
|
![]() |
Job Posts
|
![]() |
Job Stages
|
![]() |
Jobs
|
![]() |
Offers
|
![]() |
Offices
|
![]() |
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 support@vetty.co to request the web hook information.
Once you have the web hook information from Vetty, 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 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 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.
To review the background check report, click the URL under the Report field, sign into your Vetty account, and review.