BambooHR Integration
Team structure, headcount analytics, and organizational mapping.
Overview
Analyze BambooHR data to map team structures, understand headcount distribution, and identify organizational complexity. Corvana uses structural HR data to enrich operational workflow analysis.
Prerequisites
- BambooHR admin or owner access to authorize the OAuth connection
- A Corvana Assess account with an active assessment engagement
OAuth Scopes
Corvana requests the minimum necessary permissions — always read-only. The following scopes are requested during the OAuth authorization flow:
| Scope | Access Level |
|---|---|
read | Read-only |
Data We Collect
Corvana collects only structural metadata — never content, PII, or sensitive data. The following data points are analyzed:
- Department and team structure
- Headcount distribution
- Reporting hierarchy depth
- Location distribution
- Team size patterns
Data We Never Collect
To protect your privacy and security, the following data is explicitly excluded from collection:
- Never: Employee PII or salary data
- Never: Performance reviews
- Never: Time-off requests
- Never: Benefits information
- Never: Personal documents
Setup Steps
Step 1: Navigate to Integrations
From your Corvana Assess dashboard, open the left sidebar and click Integrations.
Step 2: Connect BambooHR
Find the BambooHR card and click Connect BambooHR. This initiates the OAuth flow.
Step 3: Authorize Access
Review the requested permissions on BambooHR's authorization page and click Allow. Corvana requests read-only access only.
Step 4: Verify Connection
Return to the Corvana dashboard. The BambooHR card should now show "Connected" with a green indicator. Data collection begins within minutes.
Disconnecting
You can disconnect BambooHR at any time from the Integrations dashboard. Click the connected BambooHR card and select Disconnect. All collected metadata is permanently deleted within 24 hours. You can also revoke access directly from BambooHR's admin panel.
Troubleshooting
The BambooHR connection shows "Disconnected"
Try reconnecting from the Integrations dashboard. If the issue persists, check that your BambooHR admin has not revoked the OAuth authorization.
I don't see any data after connecting
Data collection typically begins within 5-10 minutes. If no data appears after 30 minutes, check your connection status and ensure the account has the required permissions.