Purpose: To help you understand what GoodHire is used for and how you can integrate it with BambooHR.
GoodHire delivers a quick, simple and efficient background check experience for you and your candidates.
You can learn more about GoodHire in BambooHR's Marketplace.
BambooHR Applicant Statuses
Before you enable the integration, you will need to add a few new statuses to your Candidate Status list in BambooHR's Applicant Tracking feature.
To add new statuses, go to "Hiring" in Settings and select "Candidate Statuses." We recommend you add three new status options to the list:
- Initiate Background Check - GoodHire
- Pending Background Check - GoodHire
- Complete Background Check - GoodHire
Only one status is required to initiate the process and the other two are recommended. You may phrase each status however you'd like but we suggest making it obvious that the status is referring to a background check within GoodHire.
Log in to your GoodHire account. Navigate to "Account" and select "Integrations." Turn the BambooHR integration to "ON."
Confirm in the pop-up box that you have added your custom statuses in BambooHR as previously mentioned above.
1. Provide your BambooHR Subdomain
Enter your BambooHR subdomain* and click "Save."
*The subdomain is the first part of your BambooHR URL. For example, if your BambooHR URL is https://helpcontent.bamboohr.com then your subdomain would be "helpcontent."
You will then see a pop-up letting you know that you will be redirected to your BambooHR account in order to log in. This will allow the integration to automatically obtain an API key from your BambooHR account.
Log in to BambooHR.
2. Configure your Background Check Statuses
Your custom candidate statuses in BambooHR will automatically transfer over to the drop-down lists in step 2. Select the applicable custom status options:
- Select "Initiate Background Check - GoodHire." (Required)
- Select "Pending Background Check - GoodHire" and "Complete Background Check - GoodHire." (Optional)
This allows your applicants in BambooHR to automatically change statuses based on the status of the background check in GoodHire.
Click "Save & Continue."
3. Set Notification User
If you'd like someone to be notified when a candidate's information is exported from BambooHR to GoodHire, select the user from the drop-down list and click "Save."
The integration will officially be activated.
Log into BambooHR. Navigate to the candidate's profile and change the status to "Initiate Background Check - GoodHire."
The candidate will then be exported to GoodHire within 15 minutes. A notification will be sent to the user selected during the integration setup to let them know they can run the background check.
The user can click "Go to Queued Reports" in the notification in order to run the background check.
Additionally, the user can log in to GoodHire and navigate to "Background Checks" and then "Queued Results."
Once viewing Queued Results, click "Run" next to the candidate's name.
Select the Background Check package from the drop-down list and then click "Run this package."
If you view the candidate in BambooHR, you will see that the status has automatically been changed to "Pending Background Check - GoodHire" if you are using this optional status.
Once the background check is complete, the candidate's status will automatically move to "Complete Background Check - GoodHire" in BambooHR and a notification email will be sent to the notification user to allow them to view the background check results.