# 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](https://docs.coupler.io/sources/category/project-management/bamboo-hr/data-overview) article. For connection errors or missing data, check [Common Issues](https://docs.coupler.io/sources/category/project-management/bamboo-hr/common-issues). For setup recommendations, visit [Best Practices](https://docs.coupler.io/sources/category/project-management/bamboo-hr/best-practices).
{% endhint %}