> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/project-management/bamboo-hr/faq.md).

# FAQ

<details>

<summary>Where do I find my BambooHR API key?</summary>

Log in to BambooHR, click your profile icon in the top-right corner, and select **API Keys**. Click **Add New Key**, give it a name, and copy the generated key. You'll only see the full key once, so save it somewhere secure before closing the dialog.

</details>

<details>

<summary>What is my BambooHR subdomain?</summary>

Your subdomain is the company-specific part of your BambooHR URL. For example, if you access BambooHR at `acmecorp.bamboohr.com`, your subdomain is `acmecorp`. Enter just the subdomain — not the full URL.

</details>

<details>

<summary>Can I pull data from multiple BambooHR accounts into one report?</summary>

Yes. Add each BambooHR account as a separate source within the same data flow, then use the **Append** transformation to stack the data into a single table. This is useful for organizations with multiple subsidiaries or regional BambooHR instances.

</details>

<details>

<summary>How do I pull only specific employee fields instead of everything?</summary>

Use the **Custom reports streams** entity and enter the field aliases you want in the `custom_reports_fields` parameter as a comma-separated list (e.g., `firstName,lastName,department,jobTitle`). Run the **Meta fields streams** entity first to get a full list of valid aliases for your account.

</details>

<details>

<summary>Why does my time off data only go back 30 days?</summary>

The default start date for Time off requests is 30 days before today. To pull a longer history, go to your data flow settings and use the date picker in the **Start date** parameter to set an earlier date — for example, the beginning of the current year.

</details>

<details>

<summary>Can I use BambooHR data with AI tools like ChatGPT or Claude?</summary>

Yes. When setting up your data flow, select an AI destination — options include ChatGPT, Claude, Gemini, Perplexity, Cursor, and OpenClaw. This lets you send employee or HR data directly to an AI assistant for summaries, analysis, or Q\&A.

</details>

<details>

<summary>Why are timesheet entries empty even though I have data in BambooHR?</summary>

Timesheet entries are only available if your BambooHR subscription includes the time tracking add-on. If your plan doesn't include it, the entity will return no data. Check your BambooHR plan or contact BambooHR support to confirm whether time tracking is enabled.

</details>

<details>

<summary>Can I combine BambooHR data with data from other HR or finance tools?</summary>

Yes. Coupler.io supports multi-source data flows. You can join BambooHR employee data with, for example, payroll data from another source using the **Join** transformation on Employee ID — or combine HR metrics with finance data for workforce cost reporting.

</details>

{% hint style="info" %}
For field-level details on each entity, see the [Data Overview](/sources/category/project-management/bamboo-hr/data-overview.md) article. For connection errors or missing data, check [Common Issues](/sources/category/project-management/bamboo-hr/common-issues.md). For setup recommendations, visit [Best Practices](/sources/category/project-management/bamboo-hr/best-practices.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.