# BambooHR

BambooHR is an HR management platform that centralizes employee data, time off tracking, timesheets, and workforce analytics. It's widely used by small and mid-sized businesses to manage their people operations in one place.

Connecting BambooHR to Coupler.io lets you pull your HR data into the tools and destinations you already use — without manual exports or CSV juggling.

**Why connect BambooHR to Coupler.io?**

* Sync employee directory data to spreadsheets or dashboards for headcount reporting
* Centralize time off requests and timesheet entries for payroll or workforce planning
* Combine HR data with data from other sources (e.g., project tools, finance systems) using Join or Append
* Send HR metrics to AI destinations like ChatGPT or Claude for summaries and workforce analysis

## Prerequisites

Before you connect, make sure you have:

* A BambooHR account with admin access (required to generate an API key)
* Your BambooHR **company subdomain** (the part before `.bamboohr.com` in your URL)
* An API key generated from your BambooHR account settings

To generate an API key in BambooHR: go to your profile icon → **API Keys** → **Add New Key**.

## Quick start

{% hint style="success" %}
Start with the **Employees directory** entity to get a full snapshot of your workforce — it's the most commonly used entity and a great foundation for headcount dashboards.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Create a new data flow in Coupler.io.** From your Coupler.io dashboard, click **Add data flow** and search for **BambooHR** as your source.
{% endstep %}

{% step %}
**Enter your BambooHR credentials.** You'll be asked for your API key and your company subdomain. Paste both into the fields provided.
{% endstep %}

{% step %}
**Select an entity.** Choose what data you want to pull — for example, **Employees directory streams**, **Time off requests streams**, or **Timesheet entries**. You can add more entities to the same data flow later.
{% endstep %}

{% step %}
**Choose a destination.** Select where you want your data to land — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like ChatGPT, Claude, or Gemini.
{% endstep %}

{% step %}
**Run the data flow.** Click **Run** to execute your first manual sync and confirm that data is flowing correctly.
{% endstep %}
{% endstepper %}

## Entities overview

| Entity                      | What it contains                                                     |
| --------------------------- | -------------------------------------------------------------------- |
| Custom reports streams      | Configurable reports using BambooHR field names you specify          |
| Employees directory streams | Active employee profiles — names, departments, job titles, locations |
| Meta fields streams         | Available fields and metadata in your BambooHR account               |
| Time off requests streams   | Approved, pending, and denied time off requests                      |
| Timesheet entries           | Clock-in/out records and hours worked per employee                   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coupler.io/sources/category/project-management/bamboo-hr.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.