The OneVeris integration for Ashby allows recruiters and hiring teams to initiate background checks, track progress, and review completed screenings directly within their existing workflow. By connecting OneVeris with Ashby, organizations can reduce manual work, improve visibility, and create a more efficient hiring experience.
Follow the steps below to configure the integration and begin ordering background checks through Ashby.
Enter OneVeris API Key and Base URL
The OneVeris API Key and Base URL are obtained from your OneVeris implementation team.
Once you have this information, navigate to Admin > Integrations > Integrations.
From the Integrations page, search for OneVeris in the search bar. Once the OneVeris tile appears, click on it, then click + Enable OneVeris. Enter the OneVeris API Key and Base URL provided by your OneVeris representative.
Create Ashby API Key
To create an Ashby API key, click into the Ashby API Key dropdown and add a name for your API key. After entering a name, click Create New API Key.
Once Create New API Key is selected, the API key will be displayed.
Important: This API key is only available while on this page. Navigating away and returning will cause it to disappear. Be sure to save it in a secure location.
Provide the Ashby API key to your OneVeris implementation team.
Adding the Activity
Next, add a background screening activity to a stage within your interview plan. This activity will generate a prompt allowing recruiters to initiate the background screening process when a candidate reaches the selected stage.
On the Interview Plan tab of your job, click Add Activity To… on the stage where you would like the background screening activity to appear (Background Check is used in the example).
From the Integrations section, select OneVeris.
Choose the appropriate OneVeris screening package from the Assessment Type dropdown. These screening packages are configured by your OneVeris team based on your organization’s screening program.
Once the appropriate package has been selected, click Add.
Optional: Automate Screening Initiation
You may choose to automatically initiate the background screening process when a candidate enters this stage.
To enable automation:
- 1. Open the Automation tab.
- 2. Check the box labeled Automate on Stage Entry?
- 3. Save your changes.
Once enabled, the screening activity will automatically begin when a candidate reaches the configured stage.
For more information on workflow automation, refer to Ashby’s Automation Activities documentation.
Sending a Background Check
To send a background check to a candidate using the integration, click Change Stage on the candidate’s profile and select the stage where the OneVeris screening activity was configured.
The OneVeris Background Check prompt will automatically appear on the candidate profile.
Click Start Background Check to begin the screening process. Confirm that the correct screening package is selected and click Start in the confirmation window.
Automated Workflow
If Automate on Stage Entry? was enabled, Ashby will automatically initiate the screening process when the candidate enters the designated stage.
A notification will appear indicating that the screening has been started automatically. Users have approximately 15 seconds to undo the action if necessary.
Candidate Invitation & Screening Status
Once the screening has been initiated, the status of the OneVeris Background Check will change from Ready to Start to Pending.
At this point, the candidate will receive an email requesting any information required to complete the screening process.
After the candidate submits the required information, the status will update from Pending to In Progress.
The OneVeris team will then begin processing the background screening order.
Reviewing Completed Results
Once the background screening process has been completed, the status will update to Completed on the candidate profile within Ashby.
Users will have the option to click View in OneVeris to access the completed report.
Selecting View in OneVeris will open the report in a new browser tab. Depending on your organization’s setup, users may be prompted to log in using credentials provided by OneVeris.
After authentication, the completed background screening report will be available for review.