How to Connect BambooHR to an AI Agent
Auth setup
1. Go to BambooHR > Account > API Keys. 2. Generate key. 3. Use as username in Basic auth with password 'x'.
Key facts
| Base URL | https://api.bamboohr.com/api/gateway.php/{subdomain}/v1/ |
|---|
| API version | v1 |
|---|
| Auth | API key with Basic auth. Key as username, 'x' as password. |
|---|
| Request body | application/json |
|---|
| Pagination | N/A — most endpoints return all results. Use 'fields' param to limit data. |
|---|
| Rate limit | No published rate limit but throttled on abuse. Be reasonable with polling. |
|---|
| Error format | JSON or XML depending on Accept header. |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /employees/directory | Get employee directory |
GET | /employees/{id} | Get employee details |
GET | /time_off/requests | List time off requests |
POST | /employees | Create employee |
Quickstart
GET /api/gateway.php/{subdomain}/v1/employees/directory
Authorization: Basic {base64(api_key:x)}
Accept: application/json
Agent pitfalls & tips
- Subdomain is company-specific (e.g., mycompany.bamboohr.com → subdomain='mycompany').
- Basic auth: API key as username, literal 'x' as password.
- Employee fields are configurable — use GET /meta/fields for available fields.
- Custom fields have numeric IDs — fetch /meta/fields first.
- Accept: application/json header important — defaults to XML.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is BambooHR's AEO score?
▼
BambooHR has an AEO score of 0.80 and is rated A (Functional agent integration). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is BambooHR AI-agent-ready?
▼
BambooHR is currently connectable for AI agent use. API access is available but no dedicated MCP server has been published yet. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does BambooHR compare to other HR & People services?
▼
In the HR & People category, BambooHR is rated A. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how BambooHR compares.
How can I integrate BambooHR with an AI agent?
▼
The fastest way to integrate BambooHR with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with BambooHR?
▼
API key with Basic auth. Key as username, 'x' as password. Setup: 1. Go to BambooHR > Account > API Keys. 2. Generate key. 3. Use as username in Basic auth with password 'x'.
What are BambooHR's API rate limits?
▼
No published rate limit but throttled on abuse. Be reasonable with polling.