Setup

Connect BambooHR to Ravenna through the HRIS integration and Merge Link to sync employees, teams, and departments automatically.

BambooHR connects through the HRIS integration, which uses Merge.dev for unified HRIS data access. Connecting syncs employees, teams, and departments into Ravenna.

Select BambooHR in the Merge Link provider list, then enter your BambooHR subdomain. It is the part before .bamboohr.com in your BambooHR URL, so acme.bamboohr.com means the subdomain is acme.

Prerequisites

Merge supports more HR systems than Ravenna enables by default. If yours is missing from the Merge Link provider list, ask support and it can usually be turned on.

Before you start, make sure you have:

• An active account with your HR system
• Admin access to it, or someone who has it available to authorize the connection
• Permission to authorize third-party integrations there

Connect

1. Open the HRIS integration

   1. Go to Settings > Integrations
   2. Select HRIS. One connector covers every supported HR system, so there is no separate card per provider.
2. Start the connection

   Select Connect to open Merge Link, the guided authorization dialog.

3. Authorize the connection

   1. Select your provider from the list
   2. Follow the prompts. Most providers ask for admin credentials, and some also ask for a subdomain or a tenant URL.
   3. Review the requested data permissions and accept them
   4. Select Finish
4. Choose what syncs

   Set your sync preferences after the connection completes:

   • Employee status filter: which employment statuses to sync. Defaults to Active only.
   • Group type filter: which group types to sync. Defaults to Teams and Departments.
5. Wait for the first sync

   The first sync starts as soon as the connection completes, and employee and group data appears in Ravenna once it finishes.

   Data syncs every 24 hours after that. The integration settings show the last sync time.

Troubleshooting

Merge Link authorization fails

Cause: incorrect credentials, or insufficient permissions in your HR system.

Fix:

• Check that anything you typed, such as a subdomain or tenant URL, matches your HR system exactly
• Confirm the account you authorized with has admin access
• Check that third-party integrations are not blocked in your HR system’s settings
• Try again in a different browser, since extensions can interfere with the dialog

Employees are missing

Cause: the sync has not finished, the status filter excludes them, or they have no work email.

Fix:

• Check the last sync time in the integration settings
• Confirm your employee status filter includes the statuses you expect, such as Active
• Confirm each missing person has a valid work email in your HR system. Anyone without one is skipped.
• Wait for the next 24 hour sync, or disconnect and reconnect to force a fresh one

Groups or departments are missing

Cause: the group type filter is excluding them, or they were created after the last sync.

Fix:

• Confirm your group type filter includes Teams and Departments
• Confirm the groups exist in your HR system
• Wait for the next sync to pick up new groups

Learn more about BambooHR time-off workflow actions