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 Statuses list in our 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 to Account and select Integrations. Turn the BambooHR integration toggle 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 be 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 be officially activated.

How do I initiate a background check?

Log in to BambooHR. Go to a candidate profile and change the candidate's 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 to run the background check.

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

Once viewing the Queued Results section, 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. The user will also receive an email notification 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 and navigate to the Integration section.

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?