BambooHR integration

What it does

The BambooHR integration lets you orchestrate employee records, time-off requests, and HR reports on behalf of your clients' BambooHR accounts. Use it to mirror new hires into downstream tools, surface pending time-off in Slack or email, and pipe BambooHR reports into spreadsheets or data warehouses.

Connect a BambooHR account

BambooHR uses HTTP Basic authentication with an API key as the username and the literal letter x as the password.

1. In your client's BambooHR account, open the user menu (top right) and choose API Keys.
2. Click Add New Key, name it (for example, "TaskJuice"), and copy the generated key.
3. In TaskJuice, add a new BambooHR connection and provide:
   • Subdomain: the part before .bamboohr.com in your client's BambooHR URL.
   • API key: the value you just copied.
   • Password: the literal letter x.

The connection stays linked to that client's workspace and the API key remains encrypted at rest.

Triggers

• bamboohr/new-time-off-request polls for time-off requests and emits one activation per cycle. Drop a Loop node downstream to fan out per request.

Actions

• bamboohr/list-employees returns the BambooHR employee directory.
• bamboohr/get-employee retrieves a single employee by ID with the requested fields.
• bamboohr/create-employee creates a new employee.
• bamboohr/update-employee updates fields on an existing employee.
• bamboohr/get-report retrieves a company report by ID.
• bamboohr/list-time-off-requests lists time-off requests in a date range.
• bamboohr/create-time-off-request files a new time-off request for an employee.

Known limitations

• BambooHR rate-limits API requests per account; sustained polling intervals shorter than 15 minutes are not recommended.
• Native webhooks require BambooHR's Pro plan. TaskJuice ships polling triggers so the integration works on every BambooHR tier.
• The Get Report action returns JSON by default. Non-JSON formats (CSV, PDF, XLS, XML) are returned as opaque blobs.
• Custom field IDs vary by BambooHR account; use the Get Employee action with an explicit fields list to retrieve them.