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.

How do I Enable the GoodHire Integration?

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:

  1. Initiate Background Check - GoodHire
  2. Pending Background Check - GoodHire
  3. 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.

Enable Integration

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 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:

  1. Select "Initiate Background Check - GoodHire." (Required)
  2. 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.

How do I Initiate a Background Check?

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.

What Data Syncs to GoodHire from BambooHR?

This information can be found in BambooHR's Marketplace. For more information, please click here to learn more about syncing fields.

Where do I go for Support for this Integration?

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

Contact information can be found here.

What's Next?

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

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