BambooHR

Service ID: bamboohr

BambooHR is designed with small and medium sized businesses in mind. We set you free to focus on what matters most - your people.

At a Glance

Difficulty
MODERATEAPI key authentication, with no partnership or app review
Authentication
Basic AuthAPI key over HTTP Basic, not OAuth. Each consumer supplies their own API key plus their BambooHR subdomain.
Webhooks
Virtual webhooks (Apideck polls BambooHR for employee created, updated and terminated events)
Partnership Required
No(Not required for API access. Listing on the BambooHR Marketplace is a separate, optional programme (100+ customers, security review).)
Apideck Credentials
Not available(Not available: each consumer generates and supplies their own API key and subdomain.)
Costs
Included with any BambooHR subscription, which BambooHR prices per employee per month; no separate API fee.
Sandbox Availability
AvailableAccess Sandbox(Free developer test accounts from the BambooHR Partner Portal (two per developer, dummy data only, no load testing).)
Account Type Required
Any BambooHR account (Core, Pro or Elite).
Consumer Access Level
Account Owner recommended, otherwise a custom access level carrying the permissions your integration needs.
Rate Limits
Not published. BambooHR throttles at its discretion and returns Retry-After; from 14 September 2026 that response changes from 503 to 429.

Responsibility matrix

TaskYou (Customer)Your ConsumerApideck
BambooHR accountShare the access-level requirements
Generate the API keyInstructions provided
Enter API key and subdomain in VaultImplement VaultStores credentials securely
Change detection✓ Polls via virtual webhooks
Build via the Unified APIMaintains the connector
Monitor connections✓ Via the Apideck DashboardCan revoke the API keyLogs and alerts

Environments

Single environment
BambooHR uses one set of credentials, an API key plus the account subdomain, for both testing and production, so there is no separate sandbox with its own credentials. To test, use a free BambooHR trial, a developer test account requested from the BambooHR Partner Portal, or the consumer's own account. Apideck cannot supply temporary shared test credentials for BambooHR, because the connector has no Apideck-hosted application. Take care when testing against a live account holding real employee records.

🚨Important to Know About BambooHR

  • An API key carries the permissions of the BambooHR user who created it. An under-privileged key returns a narrower set of employees and blank fields instead of an error, so missing data reads as a mapping bug rather than a permissions problem.
  • Free developer test accounts are available on request, but BambooHR provisions each one manually rather than on demand, so you cannot begin building the moment you decide to.
  • BambooHR has retired its custom-report endpoint in favour of its Datasets API. This matters only if you planned to pull report-shaped data; the unified HRIS resources are unaffected.
⚠️

4 gotchas across 4 resources

Connector-specific behaviors and limitations to be aware of

📦

4 supported resources

View field mappings, supported operations, and schema details