BambooHR integration

BambooHR is a cloud-based HR platform that enables your organization to manage the data for your newly hired candidates.

Greenhouse Recruiting's integration with BambooHR allows you to export data to BambooHR when a candidate is marked as hired in Greenhouse Recruiting.

Enable the BambooHR integration

Assign BambooHR permissions

BambooHR users don't need full admin access within BambooHR to utilize the BambooHR integration. However, users configuring the integration need Edit permissions to the following fields that are exported to BambooHR from Greenhouse Recruiting:

• First name
• Last name
• Work email
• Home email
• Home phone
• Work phone
• Mobile phone
• Hire date
• Job title
• Department
• Office

In addition to these fields, BambooHR users also need edit permissions to the Documents tab in BambooHR.

To grant these permissions, first create a Custom Access Level in BambooHR like Greenhouse Integration Access. This will be used to authenticate the integration.

Include the permission Add New Employees.

Under the Personal tab, grant Edit access to all the fields you want to import from Greenhouse Recruiting.

Next, click the Documents tab, and provide Edit access. In order to export documents from Greenhouse Recruiting, the custom access level needs edit access to current and future folders.

Create a BambooHR API key

Once the appropriate permissions have been granted to the custom access level, we recommend creating a single Greenhouse API User in BambooHR with the custom access level. Each user can then enable the integration using the same BambooHR API key and subdomain generated by this user. This way the API key and integration permissions remain the same regardless of changes to any individual users who export candidates.

Generate an API key with the Greenhouse API user in BambooHR, and copy it to a secure location.

After generating and copying your BambooHR API key for the integration, navigate to your BambooHR URL to copy your organization's BambooHR subdomain.

Your organization's subdomain is the alphanumeric value that precedes bamboohr.com. In the example of greenhouse-integration.bamboohr.com, the subdomain is greenhouse-integration.

Enable access on Greenhouse Recruiting

With your BambooHR API key and subdomain copied, each of your Greenhouse Recruiting users should complete the following steps for their individual Greenhouse Recruiting accounts to enable the integration:

Click Integrations on your navigation bar.

Search for BambooHR. Click Connect.

Paste your BambooHR API key and company subdomain.

When finished, click Save. The integration is enabled and ready to use.

Configure additional candidate data to export

In addition to the default candidate data that is exported, the following data can also be exported from Greenhouse Recruiting to BambooHR by creating custom fields:

• Salary
• Date of birth
• Hourly rate
• Contract value

To configure any of these additional data types to export, navigate to the Configure icon > Custom Options.

Follow the steps below to create the appropriate custom field for each additional data type you wish to export from Greenhouse Recruiting to BambooHR:

Custom field	Set up
Salary	Navigate to Configure > Custom Options > Offers and add a field. Enter the following details to configure the custom field: Field name: Starting Salary Type: Currency When finished, click Save. To ensure the field is set up correctly for export to BambooHR, edit the field once it's created and confirm the immutable field key is starting_salary.
Date of birth	Navigate to Configure > Custom Options > Candidates and add a field. Enter the following details to configure the field: Field name: Date of birth Type: Date When finished, click Save. To ensure the field is set up correctly for export to BambooHR, edit the field once it's created and confirm the immutable field key is date_of_birth.
Hourly rate	Navigate to Configure > Custom Options > Offers > and add a field. Enter the following details to configure the field: Field name: Hourly Rate Type: Currency When finished, click Save. To ensure the field is set up correctly for export to BambooHR, edit the field once it's created and confirm the immutable field key is hourly_rate.
Contract value	Navigate to Configure > Custom Options > Offers > and add a field. Enter the following details to configure the field: Field name: Contract Value Type: Currency When finished, click Save. To ensure the field is set up correctly for export to BambooHR, edit the field once it's created and confirm the immutable field key is contract_value.

Use the BambooHR integration

Export candidates from Greenhouse Recruiting to BambooHR

To export candidate data from Greenhouse Recruiting, navigate to a candidate's profile.

Click Mark Candidate as Hired from the On Job tab.

In the offer details panel, ensure Export to BambooHR? is set to Yes.

Click Save.

Next, click Export to BambooHR on the hired candidate's profile.

When the candidate is exported, the following data will be sent from Greenhouse Recruiting to BambooHR:

• First name and last name
• Email addresses — personal and work
• Phone Numbers — work, home, and mobile
• Start date
• Resume — if uploaded
• Cover letter — if uploaded
• Offer letter — if uploaded
• Job title
• Department
• Office

All fields listed above are exported. It's not possible to prevent these specific fields from exporting. If any of the 4 available custom fields are configured, they'll export with the candidate as well.