BambooHR API: employees, time off and reports with AI agents
The BambooHR API lets you read and update employee data, query time off, generate reports and receive webhooks about changes. Companies use it to integrate HR with payroll, identity and other tools. Access is by a user's API key, or by OAuth for partners.
What the BambooHR API offers
Employees
Read and update personal and job data.
Time off
Balances, requests and who is out.
Reports
Generate custom reports.
Tables
Job history, compensation and other tables, depending on permission.
Files
Documents tied to the employee.
Webhooks
Notices when employee data changes.
How to access the BambooHR API
- With your company’s credentialsAn API key generated in a user's profile, used with basic authentication; access follows that user's permissions. Partners use OAuth.
- The key inherits the user's permissions: restrict them.
- HR data is sensitive: apply data-protection law such as GDPR.
- Validate writes before enabling them.
Official documentation: documentation.bamboohr.com
What an iTeam agent does with the BambooHR API
Who is out today
The agent tells the teams in Slack who is on vacation or absent.
Vacation questions
An employee asks for their balance and the agent answers with their own data only.
Onboarding
On hire, the agent creates tasks and access in other systems, with approval.
Outdated records
The agent flags records with missing fields and chases HR.
From the credential to the agent at work, with approval
Integration user
Create a user with minimal permissions and generate the API key.
Vault and allowed fields
Store it in the iTeam vault and limit sensitive fields, such as compensation.
Test with approval
Data writes go through human approval.
Ready-made AI teams that use BambooHR
Questions about the BambooHR API
Is the BambooHR API free?
The API is part of BambooHR for customers, with no separate charge announced.
Do I need to write code to use the BambooHR API with iTeam?
Not necessarily. iTeam's HTTP tool reads the API documentation and learns the endpoints, and the deployment team sets up credentials, permissions and tests with you.
Does the BambooHR API have webhooks?
Yes, you can set up webhooks to notify you of changes to employee fields.
