Connect Viio to your BambooHR tenant to sync your core employee directory—people, departments and org units. The sync is read‑only and usually completes in minutes.
Capabilities
Capability | What it means in Viio |
✅ Employees | Pulls name, primary email, department and employment status for every account, so you can map SaaS usage to real people. |
✅ Organisation | Imports groups and org units, plus tenant‑level details such as primary domain. |
Prerequisites
BambooHR Admin (or service account with equivalent rights) to create the API token.
Your BambooHR sub‑domain (e.g. https://mycompany.bamboohr.com).
Best practice: create a dedicated service account so the token never gets deactivated when employees change roles.
Setup
Go to Viio → Integrations and choose BambooHR – Employees & Organisation.
In a new browser tab, generate an API token in BambooHR:
Log in, click your name (lower‑left corner), and choose API Keys.
Click Add New Key, give it a name like Viio sync, and press Generate Key.
Copy the token—BambooHR shows it only once.
Back in Viio, click Connect BambooHR.
Paste the API token and enter your sub‑domain.
Click Save. Viio starts the first data sync—typically finished within 15 minutes.
Need to disconnect? In Viio, open Installed apps → BambooHR → Remove.
Troubleshooting & FAQ
Symptom | Quick fix |
“Invalid token” on connect | The token was revoked or copied incorrectly. Create a new token and reconnect. |
403 “Forbidden” after sync starts | The token‑owner lacks read access to users or System Log. Re‑create the token with a Super Admin or service account. |
Data stopped updating | Tokens expire if unused for 30 days. Re‑generate a token and reconnect. |
Technical Details
Auth method: Basic Auth with the API token as the username and any value (e.g.
x) as the password.Key endpoints called (BambooHR API v1):
GET /api/v1/employees/directory– fetch employee directory.GET /api/gateway.php?request=meta/fields– fetch custom fields (for future mapping).GET /api/v1/reports/custom?format=JSON– organisation report, when enabled.
Viio is strictly read‑only; it never creates, edits, or deletes data in BambooHR.
Data refresh cadence: every 24 hours
Additional resources
BambooHR API getting started – https://documentation.bamboohr.com/docs/getting-started
Viio security statement – https://www.viio.io/security
Need more help? Chat with Viio Support or email [email protected].