Skip to main content
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: Choose 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

Cause: Sync not yet complete or filter settings excluding employeesSolution:
  • Check the last sync time in integration settings
  • Verify your employee status filter includes the statuses you expect (e.g., Active)
  • Wait for the next 24-hour sync cycle
  • Try disconnecting and reconnecting the integration
Cause: Group type filter may be excluding certain group typesSolution:
  • 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

​
Features

Once connected, you can use BambooHR data in workflows:

Workflow actions

Check time-off balances and create time-off requests through workflow automations