Vetty enables organizations to streamline the hiring process by providing background screening, onboarding, and continuous monitoring solutions.
Goal: The primary purpose of the Vetty - Greenhouse integration is to get candidates from Greenhouse into Vetty to initiate and manage the background verification process.
Greenhouse Integration Configuration
Set up requirements for integration
- A Greenhouse account
- A Vetty Client account
- A Greenhouse account user with Site Admin and Developer permission
Enable Greenhouse Version V3 in Vetty Admin
- The Edit Details pop-up will appear.
- Verify that Greenhouse is selected in the Select ATS dropdown.
- Turn Version V3 ON using the toggle.
- Click Update to save the configuration.
To begin this process next, navigate to the Vetty Client Portal.
Authentication required for entire V3 integration
The Greenhouse integration must be authenticated through the Vetty Client Portal.
Setup the data transfer from Vetty to Greenhouse
Log in to the Vetty Client Portal.
Navigate to Settings.
Once Version V3 has been enabled in Admin, a new Greenhouse Partner option will become available in the Vetty Client Portal under the Partner tab.
Complete the required authentication process.
Click Connect under Setup the data transfer from Vetty to Greenhouse.
After clicking "Connect," authorize Vetty to access your Greenhouse account and then click "Login to Greenhouse."
Below is the list of permissions for the full Greenhouse V3 integration.
After successful authorization, the user will be redirected to the Client Login page.
Note: To access the updated V3 experience, the user can either:
- Log in again to the Client Portal, or
- Refresh the existing Client Portal browser tab.
Add webhook details in Greenhouse
- Select the Greenhouse User from the dropdown.
- Enter the Secret Key in the Secret Key field.
- Enter the Greenhouse Webhook URL in the Postfix field.
- Click the Add button.
- A success confirmation pop-up will appear, indicating that the webhook has been added successfully.
Note: If the user clicks the Add button again for an already configured Greenhouse webhook in the Vetty Client Dashboard, a validation pop-up will appear indicating that the webhook has already been configured, as shown below.
Verify webhook setup confirmation
- In Greenhouse, head to Configure
> Dev Center > Web Hooks.
- You will find a newly created webhook with the name "Vetty GH."
- After completing authentication, the Admin can map the Greenhouse Job Name to the corresponding Vetty Package and click Generate ATS, as shown below.
Note: This step is required only for new users setting up the Greenhouse V3 integration for the first time.
Use the Vetty integration with Greenhouse
Upon moving the candidate to the "Background Check" stage, an order is triggered from Greenhouse to the Vetty system (see below).
Once the candidate is created in Vetty, the status and notes are reflected in both Greenhouse and the Vetty Client Portal.
Candidate receives an invite link via email.
Candidate sets password.
Candidate completes the CES flow.
Once the background check is completed in the Vetty system, the results and status details (such as Pending Candidate, Review Needed, Clear, etc.) can be accessed from the candidate's profile.
These details are available under "Additional Details" within the candidate's profile in Greenhouse.
To review the background check report, click the URL under the Report field, sign into your Vetty account, and review.
Additional resources
For additional information not covered here, reach out to support@vetty.co.