Help Center
Open app
Help CenterIntegrationsConnect BambooHR

Integrations

Connect BambooHR

How to connect BambooHR so Doow can map your employees to departments, teams, and cost centres.

Connecting BambooHR lets Doow map your workforce to departments and teams, which unlocks department-level spend breakdowns, per-team utilisation reports, and cost-centre allocation. Doow requests read-only access and never modifies your BambooHR data.

What Doow reads from BambooHR

When you connect BambooHR, Doow pulls:

  • Employee directory — name, work email, employee ID, status (active/inactive), and hire date
  • Department and division — the department, division, and location fields from each employee profile
  • Job title and manager — reporting hierarchy for team-level aggregation
  • Employment status — full-time, part-time, contractor

Doow does not read: compensation, salary, performance reviews, time-off data, documents, or any custom fields beyond the standard department and title fields.

Before you start

You need:

  • A BambooHR account with Admin access (required to generate an API key)
  • Your BambooHR subdomain (e.g. acmecorp from acmecorp.bamboohr.com)

Step 1 — Generate a BambooHR API key

  1. Sign in to BambooHR as an administrator.
  2. Click your profile icon in the top-right and select API Keys (or go directly to https://[your-domain].bamboohr.com/settings/permissions/api.php).
  3. Click Add New Key.
  4. Give it a name (e.g. "Doow integration") and click Generate Key.
  5. Copy the API key immediately — BambooHR only shows it once.

Step 2 — Enter the key in Doow

  1. In Doow, go to Settings → Integrations.
  2. Click Connect integration and select BambooHR.
  3. Enter your BambooHR subdomain (e.g. acmecorp).
  4. Paste the API key.
  5. Click Connect.

Doow validates the key and begins syncing your employee directory. The initial sync usually takes under 5 minutes.

Step 3 — Verify the mapping

Once the sync completes, try this quick check:

  1. Go to the Dashboard and add the Department spend breakdown widget (if not already visible).
  2. Confirm it shows your departments and headcounts.
  3. Go to the Applications page, open any app, and check the Usage tab — the department column should now show department names from BambooHR instead of "Unknown."

If department names are missing or show "Unknown," the mapping between your BambooHR departments and Doow may need adjustment. Contact support via the in-app chat — the mapping is configured on Doow's side.

Data refresh

BambooHR syncs once every 24 hours by default. Changes in BambooHR (new hires, departures, department changes) are reflected in Doow within a day. To force an immediate sync, go to Settings → Integrations → BambooHR and click Sync now.

Disconnecting BambooHR

  1. Go to Settings → Integrations.
  2. Find the BambooHR integration card and click the menu (three dots).
  3. Select Disconnect.
  4. Confirm. Department and team data stops updating.

Historical department mappings are preserved. Applications and reports that were already tagged with department data retain that information — new data will simply show "Unknown" for department until you reconnect or connect a different HRIS.

To revoke access from the BambooHR side: sign in to BambooHR, go to Settings → API Keys, find the Doow key, and click Revoke.