FAQ

Where do I find my BambooHR API key?

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.

What is my BambooHR subdomain?

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.

Can I pull data from multiple BambooHR accounts into one report?

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.

How do I pull only specific employee fields instead of everything?

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.

Why does my time off data only go back 30 days?

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.

Can I use BambooHR data with AI tools like ChatGPT or Claude?

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.

Why are timesheet entries empty even though I have data in BambooHR?

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.

Can I combine BambooHR data with data from other HR or finance tools?

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.

For field-level details on each entity, see the Data Overview article. For connection errors or missing data, check Common Issues. For setup recommendations, visit Best Practices.