Data Connector - How to Connect to BambooHR

Overview

RedFlag’s Data Connector Integration allows you to seamlessly sync recipient profile data from BambooHR into RedFlag—eliminating the need for manual uploads.

Once BambooHR is connected, you can map incoming fields to RedFlag profile fields. Data will sync automatically, keeping your recipient list up to date.

🛡️ Note: This feature must be enabled by RedFlag on the backend before configuration is available in your account.

Requirements for BambooHR Connection

  • Subdomain – The unique portion of your BambooHR URL used to access your account (e.g., mycompany in https://mycompany.bamboohr.com).
  • API Key – Required for authentication during setup.
  • Configure BambooHR in RedFlag’s Data Connector

How to Find Your API Key in BambooHR

🛡️ Note: It’s recommended that a person with the Account Owner role creates the API key for full read/write access.

  1. Log in to your BambooHR account.
  2. Click on your profile in the top-right corner.
  3. Select API Keys from the dropdown menu.
  4. If no API key exists, click Add New Key to create one.
  5. Copy your API Key and Subdomain to enter in RedFlag’s Data Connector.

Pre-existing Access Levels

BambooHR provides the following pre-existing access levels:

  • Employee Access Level – For employees who should only see their own data (not recommended for API key owners).
  • Manager Access Level – For managers who can view limited team data (not recommended for API key owners).
  • Custom Access Level – Allows tailored data visibility (recommended for API key owner if no Account Owner role is available).

To review these:

  1. Click the Settings (⚙️) icon at the top right.
  2. Select Access Levels from the left navigation.
  3. Click the + button next to Levels to view or add access types.

How to Create Custom Access Levels

To create and assign a custom access level for integration users:

  1. Log in as an Account Owner or Admin.
  2. Go to Settings (⚙️)Access Levels.
  3. Click + beside Levels and select Custom Access Level.
  4. Enter a name for the access level and click Next.
  5. Customize visibility and permissions → Next Step.
  6. Under What this Access Level Can See, ensure you’re in See About Other Employees.
  7. Select the appropriate data permissions.
  8. Save changes and assign users:
    • Click the custom access level name.
    • Select Add Employee, choose the user, and click Done.

Once assigned, the user can create API keys with the chosen access scope.

Configure BambooHR in RedFlag’s Data Connector

Now that your custom access and API key are ready:

  1. Open RedFlag’s Data Connector.
  2. Enter your Subdomain and API Key credentials.
  3. Save the configuration.

Your BambooHR account is now connected 🎉 After connecting, complete configuration to start importing your data.