Welcome to Checkr!
This guide will walk you through the Checkr / Freshteam integration process, and outline how to use the Checkr dashboard for the background check process.
The Checkr Help Center is a great resource for any questions that may not be covered in this user guide. If you have any questions not covered in this guide that are specific to Freshteam, please fill out a support request within Freshteam for assistance.
_________________________________________________________
- Prerequisites
- Add Checkr to Freshteam
- Ordering background check for a candidate
- Viewing your Candidate assessment background check status
- Viewing reports & Using tags to filter candidate background checks
- Use the Checkr Dashboard
_________________________________________________________
This guide describes how to set up Checkr to use within Freshteam, such that Freshteam users can initiate and view Checkr background checks from within the Freshteam interface.
Prerequisites
The following items are required to initiate Freshteam / Checkr integration. Please ensure you have the following before proceeding.
- Access to Freshteam as a Premium user with admin rights
Add Checkr to Freshteam
First, enable Checkr from within Freshteam. You must have admin access to both Checkr and Freshteam to complete this process.
- Go to Settings > General Settings > Integrate with other Apps > Apps
- You can search for “Checkr” from the search bar on the page or you can find it under "All" in the Browse by Category Section.
- Here, you will find "Checkr”, click on the Install button next to it, to initiate the integration.
- It will take you to the configurations page
The configuration page is divided into 3 parts
- Connect Checkr:
Click on " Install", and you will be shown the Checkr login page as seen below.
Existing Checkr Customer: Click "Sign in", and log in using your existing checkr credentials. Please login via a user account that has admin access on Checkr to give the required API access.
New Checkr Customer: Fill in all required details to create a new Checkr account, Checkr verifies your company details, and activates your account in a few days.
- Connect Freshteam:
Here 2 parameters are required:
- Domain Name: Your Freshteam domain URL will be auto-populated
- API Key: You can find your API key by clicking on your profile icon at the top-right corner of the screen. Know More
- Configuration: Here, provide the list of roles that will be able to initiate the BG check (see below). Click Install to complete the installation!
Now you have Checkr Integrated with Freshteam!
Ordering background check for a candidate
To order Checkr background verification through Freshteam, simply follow the following instructions
- Click on recruitment tab --> Select a job --> Select candidate --> Click on Checkr icon on the right
- Checkr tab will slide out, then fill in the candidate PI data along with the Checkr background check you want to run
- Once all the data is filled click on "Order BG Check" This will enable the background check for the package selected
Below images show the various steps:
Image 1: Filling basic details to initiate background verification
Image 2: Selecting the Checkr background verification package
Viewing your Candidate assessment background check status
Administrators or users with access permissions to adjudicate can view the background check status within Freshteam. There are a total of 3 color codes used to define the stage of the background check:
Green: Approved
Yellow: Pending
Red: Consider
You can view the candidate background check status one of two ways.
- From the Comments tab in 360 view, this tab shows the detailed scope of things around the candidate background check along with other background check related information.
The above image shows the candidate background check status in candidate 360 view
- You can also view the status directly from the Checkr Dashboard by selecting View Full Report. You must have the correct Checkr User permissions to access.
Viewing reports & Using tags to filter candidate background checks
Enabling background verification also creates tags in the process. Tags can be used to filter candidates who are in various stages of the process. There are two candidate tags that are created, Checkr-Complete and Checkr-Pending.
See below for a quick preview of this feature and a reference table for available Tags.
Checkr and Freshteam Status Mapping reference table:
Checkr Report Status |
Checkr Report Result |
Freshteam Status in Candidate page and comments |
Freshteam Tag |
Freshteam Comment added? |
Invitation Status |
NA |
Invitation Sent |
Checkr-pending |
Yes |
Invitation Expired |
NA |
Invitation Expired |
Checkr-Complete |
Yes |
Invitation Deleted |
NA |
Invitation Canceled |
Checkr-Complete |
Yes |
Invitation Completed |
NA |
Invitation Completed |
Checkr-pending |
No |
Complete |
Clear |
Eligible |
Checkr-Complete |
Yes |
Complete |
Consider |
Pending |
Checkr-Complete |
Yes |
Disputed |
NA |
Disputed |
Checkr-Complete |
Yes |
Suspended |
NA |
Suspended |
Checkr-Complete |
Yes |
Pending |
NA |
Pending |
Checkr-pending |
No |
Complete |
Clear |
Clear |
Checkr-Complete |
Yes |
Complete |
Consider |
Not Eligible |
Checkr-Complete |
Yes
|
Use the Checkr Dashboard
While the Freshteam integration allows users to order background checks and view their status, the following features are available only within Checkr:
- Background check invitation links
- Full background check report results
- Adverse Action initiation and processing tools
- Create customizable packages and add-ons
- Checkr settings
For a quick overview of the Checkr Dashboard, please see Getting started with Checkr.