> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

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

<Info>Connect to BambooHR through Merge.dev for unified HRIS data access</Info>

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

<Steps>
  <Step title="Navigate to integrations">
    1. Go to **Settings > Integrations**
    2. Find **BambooHR** in the HRIS section
  </Step>

  <Step title="Start the connection">
    Click **Connect** on the BambooHR integration card to begin the Merge Link flow.
  </Step>

  <Step title="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
  </Step>

  <Step title="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)
  </Step>

  <Step title="Wait for initial sync">
    The initial data sync begins automatically after connection. Employee and group data will be available once the sync completes.

    <Info>
      Data syncs automatically every 24 hours after the initial sync. You can view the last sync time in the integration settings.
    </Info>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>
</AccordionGroup>