Integration of Greenhouse with SpringVerify
Overview
This integration enables users to seamlessly initiate background verification checks for candidates. Verifications can be automatically triggered at critical hiring stages — such as when an offer is approved or a candidate is hired — accelerating the onboarding process.
There are two ways to connect Greenhouse with SpringVerify:
- Flow A – Connect with Greenhouse (OAuth, managed by SpringVerify)
- Flow B – Use your own Greenhouse credentials (Harvest V3 OAuth)
Flow A: Connect with Greenhouse (OAuth)
Navigate to the Integrations page on the SpringVerify portal. Locate and select the Greenhouse card to begin the integration process.
Click the "Connect" button to enable the integration. "Connect with Greenhouse" is selected by default. Click "Continue" to proceed.
You will be redirected to the Greenhouse permission page. Enter the email address associated with your Site Admin account in Greenhouse and click "Log in to Greenhouse" to proceed.
Check the "Authorize as a service account" checkbox and click "Authorize" to proceed.
You will be redirected to the SpringVerify portal, where a success message will confirm the integration is connected.
Create the required custom fields in Greenhouse and map them to the corresponding fields on the SpringVerify Package Mapping page. Once the mapping is complete, click "Save" to proceed.
Go to the "Report Push" tab and enable the toggle to allow SpringVerify reports to be pushed to Greenhouse.
Go to the "Settings" tab to configure candidate notification preferences. By default, an email is sent to the candidate to complete the BGV form. You can disable the email notification by turning off the toggle. You can also configure the trigger based on the candidate's stage — for example, when the candidate moves to the Hire stage or when an Offer is approved. Update the required settings and click "Save" to apply.
In Greenhouse, add a candidate with the required basic information (Name, Email Address, Phone Number). Move them to the configured trigger stage. Once triggered, the candidate will be automatically added to the SpringVerify portal.
Flow B: Use Your Own Greenhouse Credentials (Harvest V3 OAuth)
Select the second option — "Use your own Greenhouse credentials" — and click "Continue" to proceed.
In Greenhouse, click "Configure Settings" in the top-right corner. Navigate to Dev Center → API Credential Management and create a Harvest V3 OAuth Credential.
Click "Create New API Credential." A modal will open. Select "Harvest V3 OAuth" as the API Type and enter a suitable name in the Description field. Then click "View and Store Credentials" to generate the credentials.
Copy the Client ID and Client Secret and store them securely. Once saved, click "I have stored the client credentials."
In the next window, select the "Harvest" checkbox and grant all required permissions for the Client ID and tenant. Click "Save" to proceed.
Enter the Client ID and Client Secret in the corresponding fields on the SpringVerify portal and click "Save Credentials" to proceed.
You will be redirected to a confirmation window. Copy the Endpoint URL and Secret Key — you will need these to create a Webhook in Greenhouse.
Navigate to the Web Hooks section in the Greenhouse portal and select "Webhooks."
Retrieve the URL endpoint and secret key from the SpringVerify portal and copy them.
In Greenhouse, click "Create Web hook" and input the following details. SpringVerify currently supports BGV for two trigger events:
- Offer approved
- Candidate has been hired
Once completed, click "Create Web hook."
After verifying the status, return to the SpringVerify portal to proceed with additional configurations and save the package mapping.
Go to the "Report Push" tab and enable the toggle to allow SpringVerify reports to be pushed to Greenhouse.
Go to the "Settings" tab to configure candidate notification preferences. Update the required settings and click "Save" to apply.