BambooHR API

Name: BambooHR API API
Brand: BambooHR API
Availability: InStock

★ Only Publicly Available SpecHR recruitingEmployee Managementoauth2, basic164 EndpointsREST

For Agents

Query employee records, submit time-off requests, run custom reports, and manage benefits, payroll, and hiring pipelines across an entire BambooHR account.

Quickstart

Get started with BambooHR API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get employee profile from BambooHR"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with BambooHR API API.

Pull employee directory listings and individual profile records with custom field support

Submit and approve time-off requests with policy-aware balance calculations

Generate custom reports with flexible field selection and filtering criteria

Track applicant pipeline stages from application through hiring decision

GET STARTED

Start building with BambooHR API API

Explore with Jentic

View OpenAPI Spec

Jentic publishes the only available OpenAPI specification for BambooHR API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for BambooHR API, keeping it validated and agent-ready. Access and manage the full employee lifecycle through 164 endpoints spanning employee records, time-off requests, benefits administration, payroll data, goals tracking, applicant tracking, and training management. Supports company-scoped multi-tenant access with OAuth 2.0 or HTTP Basic authentication for programmatic HR automation.

Use Cases

Patterns agents use BambooHR API API for, with concrete tasks.

★ AI Agent HR Data Retrieval

AI agents use the BambooHR API through Jentic to fetch employee records, time-off balances, and organizational data without direct BambooHR credentials. An agent searches for 'get employee details', loads the schema for the employee endpoint, and retrieves structured profile data including custom fields. This enables HR chatbots, onboarding automations, and self-service portals to pull real-time workforce data.

Retrieve the full employee profile for employee ID 123 including custom fields and return their department, manager, and hire date

Time-Off Automation

Automate the full time-off lifecycle from request submission through approval and balance tracking. The API exposes endpoints to submit requests with specific date ranges and absence types, check remaining balances against policies, and update request statuses. Integrations typically connect with Slack bots or internal portals so employees request PTO without logging into BambooHR directly.

Submit a 2-day vacation request for employee ID 456 starting next Wednesday and verify the remaining balance afterwards

Custom Reporting and Analytics

Generate on-demand or scheduled custom reports pulling any combination of employee fields across the workforce. The custom reports endpoint accepts field lists and filter criteria, returning structured data suitable for dashboards, compliance audits, or headcount planning. Reports can include compensation, tenure, demographics, and custom field data.

Generate a custom report listing all employees hired in the last 90 days with their department, title, and manager name

Applicant Tracking Integration

Connect hiring workflows with external systems by accessing applicant data, tracking candidates through pipeline stages, and syncing hiring decisions. The applicant tracking endpoints expose job postings, applications, candidate profiles, and status transitions. Recruiting teams integrate this with scheduling tools, assessment platforms, and onboarding systems.

List all applicants in the 'Interview' stage for the Engineering department and return their names and application dates

Benefits Administration Sync

Synchronize benefits enrolment data between BambooHR and insurance carriers, payroll systems, or benefits administration platforms. Endpoints cover company benefit plans, employee enrolment records, deduction types, and coverage details. Automations ensure new hires are enrolled and life-event changes propagate to downstream systems without manual data entry.

Retrieve all active benefit enrolments for employee ID 789 including plan names, coverage levels, and monthly deduction amounts

Key Endpoints

164 endpoints — jentic publishes the only available openapi specification for bamboohr api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/{companyDomain}/v1/employees/directory

List the employee directory

GET

/{companyDomain}/v1/employees/{id}/tables/{table}

Get employee tabular data

POST

/{companyDomain}/v1/reports/custom

Generate a custom report

PUT

/{companyDomain}/v1/employees/{employeeId}/time_off/request

Submit a time-off request

GET

/{companyDomain}/v1/employees/{employeeId}/time_off/policies

Get time-off policies for an employee

GET

/{companyDomain}/v1/employees/changed

List recently changed employee records

GET

/{companyDomain}/v1/benefit/company_benefit

List company benefit plans

GET

/{companyDomain}/v1/employees/{employeeId}/time_off/calculator

Calculate time-off balance

GET

/{companyDomain}/v1/employees/directory

List the employee directory

GET

/{companyDomain}/v1/employees/{id}/tables/{table}

Get employee tabular data

POST

/{companyDomain}/v1/reports/custom

Generate a custom report

PUT

/{companyDomain}/v1/employees/{employeeId}/time_off/request

Submit a time-off request

GET

/{companyDomain}/v1/employees/{employeeId}/time_off/policies

Get time-off policies for an employee

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

BambooHR OAuth 2.0 tokens and API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens tied to a specific company domain — raw API keys never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'get employee time off balance') and Jentic returns matching BambooHR operations with their input schemas and required path parameters, so the agent can call the right endpoint without parsing BambooHR's documentation.

Time to first call

Direct BambooHR integration: 2-4 days for auth setup, endpoint discovery across 164 endpoints, and error handling. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

HiBob API

Modern HRIS platform with employee management, time-off, and lifecycle workflows

Choose HiBob when the organisation uses Bob as their HRIS, particularly for mid-market companies with global teams needing multi-country support

Alternative

Personio API

European HR platform covering employee records, absence, attendance, and payroll

Choose Personio when the company is Europe-based and needs GDPR-compliant HR management with integrated payroll

Complementary

Gusto Embedded Payroll API

Payroll processing, tax filing, and contractor payments for US companies

Choose Gusto alongside BambooHR when you need full payroll processing and tax compliance that BambooHR's payroll module does not cover

Complementary

Lever API

Dedicated ATS with candidate pipeline, interview scheduling, and offer management

Choose Lever for advanced recruiting workflows when BambooHR's built-in applicant tracking is insufficient for high-volume hiring

FAQs

Specific to using BambooHR API API through Jentic.

Why is there no official OpenAPI spec for BambooHR API?

BambooHR does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call BambooHR API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the BambooHR API use?

The API supports two authentication methods: OAuth 2.0 authorization code flow (recommended for production integrations) and HTTP Basic auth using an API key as the username with an empty password. OAuth tokens are obtained from https://{companyDomain}.bamboohr.com/authorize.php. Through Jentic, credentials are stored in the MAXsystem vault and agents receive scoped tokens without handling raw API keys.

Can I generate custom employee reports with the BambooHR API?

Yes. POST to /{companyDomain}/v1/reports/custom with a JSON body specifying the fields you want (e.g., firstName, lastName, department, hireDate) and optional filter criteria. The response returns structured tabular data. You can also retrieve pre-built reports via GET /{companyDomain}/v1/reports/{id} using the report ID from the BambooHR UI.

What are the rate limits for the BambooHR API?

BambooHR enforces a rate limit of 50 requests per 15-second window per API key. Exceeding this returns HTTP 429. The response includes a Retry-After header indicating when the next request can be made. For bulk operations, batch employee change detection via GET /{companyDomain}/v1/employees/changed to identify only modified records.

How do I submit a time-off request through Jentic?

Search Jentic for 'submit employee time off request', load the schema for PUT /{companyDomain}/v1/employees/{employeeId}/time_off/request, and execute with the employee ID, date range, and time-off type. Before submitting, call GET /{companyDomain}/v1/employees/{employeeId}/time_off/calculator to check the available balance. Install with pip install jentic.

Does the BambooHR API support webhooks for real-time updates?

Yes. The Webhooks resource allows you to register HTTP callback URLs that receive notifications when employee records change. Events include new hires, terminations, field updates, and time-off status changes. This eliminates the need for polling the employees/changed endpoint for near-real-time integrations.