BambooHR Trigger
What it does: Fires your workflow in real time whenever an employee record changes in BambooHR — new hires, terminations, time-off requests, job info updates, and more.
In simple terms: Connect your HR system to your workflows so that employee lifecycle events automatically trigger onboarding, offboarding, approvals, notifications, and reporting — without anyone needing to manually kick them off.
When to Use This
- ✅ Start an onboarding workflow the moment a new employee is added
- ✅ Trigger offboarding tasks when an employee is deleted or status changes
- ✅ Send Slack notifications when time-off requests are created or approved
- ✅ Update a Notion or Airtable database when employee info changes
- ✅ Sync BambooHR records to Salesforce, HubSpot, or other CRMs
- ✅ Alert managers when employment status changes
Supported Events
Employee Events
| Event | Description |
|---|---|
employee.created | A new employee record is added |
employee.updated | Employee profile fields are changed |
employee.deleted | An employee record is removed |
Time Off Events
| Event | Description |
|---|---|
timeOff.created | A new time-off request is submitted |
timeOff.updated | A time-off request is modified |
timeOff.deleted | A time-off request is removed |
timeOff.approved | A time-off request is approved |
timeOff.denied | A time-off request is denied |
timeOff.cancelled | A time-off request is cancelled |
Job & Status Events
| Event | Description |
|---|---|
jobInfo.updated | Job title, department, or manager changes |
employmentStatus.updated | Employment status changes (e.g., full-time → part-time, active → terminated) |
Prerequisites
- A BambooHR account with API access
- Admin permissions to configure webhooks in BambooHR
- A BambooHR API key (Account → API Keys)
Setup Guide
Step 1 — Connect Your BambooHR Credentials
- Add the BambooHR Trigger to your workflow
- Click Select Credentials → Create New
- Enter your API Key and Company Domain (your BambooHR subdomain, e.g.,
mycompany) - Save credentials
Step 2 — Get Your Webhook URL
- In the trigger settings, your Webhook URL is displayed automatically
- Copy the URL using the Copy button
Step 3 — Register Webhook in BambooHR
- Log in to BambooHR → Account Settings → Webhooks
- Click Add Webhook
- Paste your Webhook URL
- Select the events you want to trigger on
- Save the webhook
After registering, click Refresh in the trigger settings to update the webhook status badge.
Step 4 — Select Events
In the trigger settings, check which events should fire this workflow. You can select one or multiple events.
Configuration Reference
| Setting | Description |
|---|---|
| Credentials | Your BambooHR API key and company domain |
| Events | Which BambooHR webhook events trigger this workflow |
| Webhook URL | The platform's endpoint — paste this in BambooHR webhook settings |
Output Variables
When the trigger fires, these variables are available downstream:
| Variable | Description |
|---|---|
{{trigger.type}} | Event type (e.g., employee.created, timeOff.approved) |
{{trigger.employeeId}} | BambooHR employee ID |
{{trigger.employeeName}} | Employee's full name |
{{trigger.email}} | Employee email address |
{{trigger.department}} | Employee department |
{{trigger.jobTitle}} | Employee job title |
{{trigger.timestamp}} | When the event occurred |
{{trigger.rawPayload}} | Full BambooHR webhook payload |
Common Use Cases
1. Automated Onboarding
Events: employee.created
Workflow:
- Send welcome email to
{{trigger.email}} - Slack: Post to #new-hires channel
- Notion / Airtable: Create employee record
- GitHub: Invite to org with appropriate team
- Jira: Create onboarding task
2. Time-Off Approval Notification
Events: timeOff.approved, timeOff.denied
Workflow:
- Condition: Check event type
- Send Email: Notify
{{trigger.email}}of approval/denial - Google Calendar: Block out approved dates
- Slack: Notify team calendar channel
3. Job Title Change Alerts
Events: jobInfo.updated
Workflow:
- Slack: Notify HR channel with update
- HubSpot: Update contact job title
- Notion: Update team directory
4. Offboarding Checklist
Events: employmentStatus.updated
Workflow:
- Condition: Check if status = terminated
- IT ticket: Revoke system access
- Slack: Remove from workspace
- Send Email: Exit survey to employee
Related Blocks
- BambooHR Action: Manage employee records and time-off from within your workflows
- Send Email: Notify employees of HR updates
- Slack: Alert HR and team channels
- Notion / Airtable: Keep team directories in sync
Pro Tip: Use employee.created + employmentStatus.updated together to handle both new hires and status changes in the same workflow, routing to different paths with a Condition block.