Purpose: To help you understand what you can use GoodHire 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 Marketplace.

How do I enable the GoodHire integration?

Candidate Statuses

Before enabling 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 adding three new status options to the list:

  1. Initiate Background Check - GoodHire
  2. Pending Background Check - GoodHire
  3. Complete Background Check - GoodHire

Only one status is required to initiate the process. We recommend the other two statuses. You may name each status whatever you would like, but we suggest making a status clear that it refers to a background check within GoodHire.

Enable integration

Log in to your GoodHire account. Navigate 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.

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, your subdomain would be helpcontent.

You will then see a pop-up box letting you know you will get redirected to your BambooHR account to log in. This will allow the integration to 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 custom status options that apply:

  1. Select Initiate Background Check - GoodHire. (Required)
  2. Select Pending Background Check - GoodHire and Complete Background Check - GoodHire. (Optional)

Your selection will allow your candidates in BambooHR to automatically change statuses based on the background check status in GoodHire.

Click Save & Continue.

3. Set notification user

If you would like someone to receive a notification when a candidate's information exports from BambooHR to GoodHire, select the user from the drop-down list and click Save.

The integration will officially activate.

How do I initiate a background check?

Log in to BambooHR. Go to a candidate's profile and change their status to Initiate Background Check - GoodHire.

The candidate will then export to GoodHire within 15 minutes. A notification will send 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 to run the background check.

Additionally, the user can log in to GoodHire and navigate Background Checks to click Queued Results.

Once viewing Queued Results, click Run next to the candidate's name.

Select the background check package (PackageId) from the drop-down list and click Run this Package.

If you view the candidate in BambooHR, you will see that the status has automatically 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. An email notification will also send to the notification user to view the background check results.

What data syncs to GoodHire from BambooHR?

You can find this information in BambooHR Marketplace. To learn more about syncing fields, please click here.

Where do I go for support for this integration?

If you are an existing customer using this integration, please be aware that GoodHire supports this integration.

Click here to find contact information.

What's next?

Do you need help changing a candidate's status in BambooHR?

Need to hire a candidate and begin their self-onboarding process?