Setup

Connect BambooHR to Ravenna through the Merge.dev integration link flow to enable automatic employee, department, and group synchronization.

Connect to BambooHR through Merge.dev for unified HRIS data access

This guide walks you through connecting your BambooHR instance to Ravenna for employee and group synchronization.

Prerequisites

Before you begin, ensure you have:

• An active BambooHR account
• Admin access to your BambooHR instance
• Permission to authorize third-party integrations

Setup guide

1. Navigate to integrations

   1. Go to Settings > Integrations
   2. Find BambooHR in the HRIS section
2. Start the connection

   Click Connect on the BambooHR integration card to begin the Merge Link flow.

3. Complete Merge Link authorization

   1. A Merge Link dialog opens to guide you through the connection
   2. Select BambooHR as your HRIS provider
   3. Enter your BambooHR subdomain (e.g., yourcompany from yourcompany.bamboohr.com)
   4. Authenticate with your BambooHR admin credentials
   5. Review and accept the requested data permissions
   6. Click Finish to complete the connection
4. Configure sync settings

   After connecting, configure your sync preferences:

   • Employee status filter: Select which employment statuses to sync (default: Active only)
   • Group type filter: Select which group types to sync (default: Teams and Departments)
5. Wait for initial sync

   The initial data sync begins automatically after connection. Employee and group data will be available once the sync completes.

   Data syncs automatically every 24 hours after the initial sync. You can view the last sync time in the integration settings.

Troubleshooting

Merge Link authorization fails

Cause: Incorrect credentials or insufficient permissions

Solution:

• Verify your BambooHR subdomain is correct
• Ensure you have admin access to BambooHR
• Check that third-party integrations are not blocked in your BambooHR settings
• Try the connection again with a different browser

Employees not syncing

Cause: Sync not yet complete, filter settings excluding employees, or missing work email addresses

Solution:

• Check the last sync time in integration settings
• Verify your employee status filter includes the statuses you expect (e.g., Active)
• Confirm each missing employee has a valid work email in BambooHR. Employees without a valid work email are skipped during sync.
• Wait for the next 24-hour sync cycle
• Try disconnecting and reconnecting the integration

Groups or departments missing

Cause: Group type filter may be excluding certain group types

Solution:

• Check that your group type filter includes Teams and Departments
• Verify that the groups exist in BambooHR
• Wait for the next sync cycle to pick up new groups