Skip to main content
Let’s learn how to connect Engini to BambooHR. This integration lets your Engini workflows read and update employee records, files and time off requests in BambooHR, and start automatically when employees change or new time off requests arrive. To get started, create an account at BambooHR.

Add a Connection to BambooHR in Engini

Prerequisites

  • A BambooHR account.
  • Your BambooHR company domain. It is the first part of your BambooHR address: in mycompany.bamboohr.com, the company domain is mycompany.
  • A BambooHR API key.

Retrieve your BambooHR API Key

  1. Sign in to BambooHR.
  2. Open your profile menu and select API Keys.
  3. Click Add New Key, give the key a name and copy it.

Connecting Engini to BambooHR

  1. Enter your Engini account at https://app.engini.io.
  2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here. Engini - Connections page
  3. Click on the “New Integration” option located at the top bar. Engini - New Integration button
  4. Choose the BambooHR option from the available applications. BambooHR - Choose Application
  5. Enter the following details in the “New Integration” form and press Save: BambooHR - New Integration form 1. Connection Name - Enter a name that helps identify the BambooHR connection, for example “BambooHR - HR team”. 2. Company Domain - Enter your BambooHR company domain, for example mycompany. Enter only the first part of the address, without .bamboohr.com. 3. API Key - Enter the BambooHR API key you created. You can create it in BambooHR under your profile menu > API Keys. 4. Save - Click Save to create the connection.
Engini sends the API key with every BambooHR request made through this connection, so you don’t need to add it to any trigger or action.

Triggers

Check for New Job Summaries

Starts the workflow with the job openings in your BambooHR applicant tracking, newest first. Engini checks BambooHR on the schedule you set. BambooHR - Check for New Job Summaries trigger
  1. Starting (UTC) - Select the start date and time for the scheduled trigger.
  2. Recur every - Choose the time interval for triggering and checking job openings. The minimum time interval is 15 minutes.
  3. Add time frame - You can specify a time frame during which the trigger will operate.
  4. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Each job opening is passed to the next steps with these properties: Job Opening Id, Posted Date, New Applicants, Active Applicants, Total Applicants and Posting Url. Note: Until a platform update ships, each run can return the same records again. If duplicates matter, add a condition or a check in your workflow.

Check for New Time Off Requests

Starts the workflow when new time off requests are submitted in BambooHR. Engini checks BambooHR on the schedule you set. BambooHR - Check for New Time Off Requests trigger
  1. Starting (UTC) - Select the start date and time for the scheduled trigger.
  2. Recur every - Choose the time interval for triggering and checking time off requests. The minimum time interval is 15 minutes.
  3. Add time frame - You can specify a time frame during which the trigger will operate.
  4. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Each time off request is passed to the next steps with these properties: Request Id, Employee Id, Status, Category Id, Start Date, End Date, Amount, Unit, Requested At, Employee Note, Manager Note, Status Updated At and Status Updated By. Note: Each run looks at the requests submitted in the last 25 minutes. If the trigger runs again within that window, the same request can be delivered more than once, so add a condition or a check in your workflow if duplicates matter.

Check for New Time Offs

Starts the workflow with the time off scheduled in BambooHR from today and for the next 30 days. Engini checks BambooHR on the schedule you set. BambooHR - Check for New Time Offs trigger
  1. Starting (UTC) - Select the start date and time for the scheduled trigger.
  2. Recur every - Choose the time interval for triggering and checking time off. The minimum time interval is 15 minutes.
  3. Add time frame - You can specify a time frame during which the trigger will operate.
  4. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Each time off is passed to the next steps with these properties: Request Id, Employee Id, Time Off Type Id, Start Date and End Date. Note: Until a platform update ships, each run can return the same records again. If duplicates matter, add a condition or a check in your workflow.

Check for Updated Employees

Starts the workflow when employee records are changed in BambooHR. Engini checks BambooHR on the schedule you set. BambooHR - Check for Updated Employees trigger
  1. Starting (UTC) - Select the start date and time for the scheduled trigger.
  2. Recur every - Choose the time interval for triggering and checking employees. The minimum time interval is 15 minutes.
  3. Add time frame - You can specify a time frame during which the trigger will operate.
  4. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Each changed employee is passed to the next steps with these properties: Employee Id, Employee Number, First Name, Last Name, Display Name, Work Email, Job Title, Department, Division, Location, Status, Hire Date, Supervisor and Last Changed. Note: Each run looks at the employees changed in the last 25 minutes. If the trigger runs again within that window, the same employee can be delivered more than once, so add a condition or a check in your workflow if duplicates matter.

Employee Added

Starts the workflow when a new employee is added in BambooHR. This trigger uses a BambooHR webhook: Engini registers it automatically when you turn the workflow on and removes it when you turn the workflow off. BambooHR - Employee Added trigger
  1. Name - Enter a name for the webhook that BambooHR will use to notify Engini, for example “New employee alert”.
  2. Post Fields - Enter the BambooHR fields you want BambooHR to send with the delivery, for example firstName. BambooHR does not fill in field values for a newly created employee, so use a Get Employee step to read the details (see below).
  3. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
Each new employee is passed to the next steps with these properties: Employee Id, Action (Created), Timestamp, Changed Fields and Fields (First Name, Last Name, Hire Date and Status). Note: BambooHR sends the new employee’s Id, the action and the timestamp only; the field values are empty when an employee is created. To get the employee’s details, add a Get Employee step after the trigger and map the trigger’s Employee Id into it. Note: BambooHR groups its deliveries, so the workflow can start up to about 12 minutes after the employee is added.

Actions

Add Employee

Creates a new employee record in BambooHR. BambooHR - Add Employee action
  1. First Name - Enter the employee’s first name, for example “Jane”.
  2. Last Name - Enter the employee’s last name, for example “Smith”.
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

Change A Request Status

Changes the status of an existing time off request. BambooHR - Change A Request Status action
  1. Request Id - Select the time off request you want to change from the list, or map a Request Id from an earlier step, for example Get Time Off Requests.
  2. Status - Select the new status: Approved, Cancelled or Denied (or declined).
  3. Note - Optionally add a note. When the status is Approved or Denied, it is saved as the manager’s note on the request.

Delete Employee File

Removes a file from an employee’s profile. BambooHR - Delete Employee File action
  1. Employee Id - Select the employee whose file you want to delete from the list, or map an Employee Id from an earlier step, for example Get Employees.
  2. File Id - Select the file to delete from the list, or map a File Id from an earlier step, for example Get Employee Files and Categories.

Get a List of Absent Employees

Retrieves the employees who are out of the office within a date range. BambooHR - Get a List of Absent Employees action
  1. Start - Enter the first day of the range in the format YYYY-MM-DD, for example 2026-11-01.
  2. End - Enter the last day of the range in the format YYYY-MM-DD, for example 2026-11-14.
  3. Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Get All Updated Employee Ids

Retrieves the Ids of employees that were added, changed or deleted since a given date and time. BambooHR - Get All Updated Employee Ids action
  1. Since - Enter the date and time to start checking from, in the format 2026-01-01T00:00:00Z. The Z means UTC time.
  2. Type - Select the kind of change you want to list: Inserted (new employees), Updated (changed records) or Deleted (removed employees).

Get An Employee File

Retrieves a file from an employee’s profile. BambooHR - Get An Employee File action
  1. Employee Id - Select the employee the file belongs to from the list, or map an Employee Id from an earlier step. Use 0 for the employee linked to the API key.
  2. File Id - Select the file to retrieve from the list, or map a File Id from an earlier step, for example Get Employee Files and Categories.

Get Employee

Retrieves the details of a single employee. BambooHR - Get Employee action
  1. Employee Id - Select the employee from the list, or map an Employee Id from an earlier step, for example Get Employees.
  2. Only Current - Enter True to return only the employee’s current information, or False to include historical values. The default is False.
The action returns the employee’s standard details as fields you can map in later steps, for example First Name, Job Title, Department, Hire Date and Work Email.

Get Employee Files and Categories

Retrieves all the files of an employee together with their categories. BambooHR - Get Employee Files and Categories action
  • Employee Id - Select the employee whose files and categories you want to list from the list, or map an Employee Id from an earlier step, for example Get Employees.

Get Employees

Retrieves the list of employees in your BambooHR company directory. BambooHR - Get Employees action

Get Time Off Requests

Retrieves the time off requests within a date range. BambooHR - Get Time Off Requests action
  1. Start - Enter the first day of the range in the format YYYY-MM-DD, for example 2026-11-01.
  2. End - Enter the last day of the range in the format YYYY-MM-DD, for example 2026-11-30.
  3. Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
In Add Filter, the Request Id, Employee Id and Type (the time off type) filters let you select a value from the list, or map one from an earlier step.

Request a Custom Report

Generates a custom BambooHR report in the format you choose. BambooHR - Request a Custom Report action
  1. Format - Select the output format of the report: CSV, PDF, XLS, XML or JSON.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Add Field lets you set the report Title, the Fields to include in it, and Only Current. For Fields, select the BambooHR fields you want in the report from the list, or map the field names from an earlier step.

Update Employee

Updates the details of an existing employee. BambooHR - Update Employee action
  1. Employee Id - Select the employee you want to update from the list, or map an Employee Id from an earlier step, for example Get Employees.
  2. First Name - Enter the employee’s new first name, for example “Jane”.
  3. Last Name - Enter the employee’s new last name, for example “Smith”.
  4. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

Update Employee File

Updates a file that is already on an employee’s profile. BambooHR - Update Employee File action
  1. Employee Id - Select the employee the file belongs to from the list, or map an Employee Id from an earlier step, for example Get Employees.
  2. File Id - Select the file you want to update from the list, or map a File Id from an earlier step, for example Get Employee Files and Categories.
  3. Name - Enter the new name for the file, for example contract.pdf.
  4. Category Id - Select the category to move the file to from the list, or map a Category Id from an earlier step. The list shows the file categories of the employee you chose.
  5. Share With Employee - Select Yes to let the employee see the file, or No to keep it hidden from them.

Upload Employee File

Uploads a file to an employee’s profile. BambooHR - Upload Employee File action
  1. Employee Id - Select the employee to attach the file to from the list, or map an Employee Id from an earlier step. Use 0 for the employee linked to the API key.
  2. Category Id - Select the file category the file goes into from the list, or map a Category Id from an earlier step. The list shows the file categories of the employee you chose.
  3. File Name - Enter the name the file gets in BambooHR, for example contract.pdf.
  4. Share - Select Yes to let the employee see the file, or No to keep it hidden from them.
  5. File - Select or map the file to upload, for example a file produced by a previous step.

Send API Request

This activity allows you to send a custom API request directly to BambooHR’s API. BambooHR - Send API Request action
  1. Base Url - The root URL of the BambooHR API. It is filled in from your BambooHR connection and can’t be edited here.
  2. Relative url - You can specify additional path segments or parameters that need to be added to the end of the Base Url. This allows you to customize the specific request you want to perform.
  3. Method - Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
  4. Body Type - Defines the format of the data in the body of your request. The default, application/json, means the body contains a JSON-formatted payload.
    • application/json – Sends the request body in JSON format. Commonly used by REST APIs.
    • custom – Allows you to define a custom body format by manually setting the Content-Type header. Add a Content-Type row in Add Headers with the media type you need (for example application/xml). With any other Body Type, a Content-Type you type in Add Headers is not sent; Engini sets it from the Body Type, and the run history shows it under headersnotsent.
    • application/x-www-form-urlencoded – Sends the body as URL-encoded key-value pairs, commonly used in form submissions.
    • file – Sends a file as the request body.
    • multipart/form-data – Sends form data that may include both text fields and files.
    • text/html – Sends the request body as HTML content.
    • text/plain – Sends the request body as plain text.
    • text/xml – Sends the request body in XML format.
  5. Body - Contains any data that is being sent to the server.
  6. Add Headers - Additional metadata about the request, such as the type of data Engini can accept, the length of the request body, and authentication information.
  7. Add Queries - The query refers to the parameters or data that are included in the URL of an HTTP request to provide additional information or instructions to the server.
For the full list of endpoints, see the BambooHR API reference.