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 ismycompany. - A BambooHR API key.
Retrieve your BambooHR API Key
- Sign in to BambooHR.
- Open your profile menu and select API Keys.
- Click Add New Key, give the key a name and copy it.
Connecting Engini to BambooHR
- Enter your Engini account at https://app.engini.io.
-
Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here.

-
Click on the “New Integration” option located at the top bar.

-
Choose the BambooHR option from the available applications.

-
Enter the following details in the “New Integration” form and press Save:
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.
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.
- Starting (UTC) - Select the start date and time for the scheduled trigger.
- Recur every - Choose the time interval for triggering and checking job openings. The minimum time interval is 15 minutes.
- Add time frame - You can specify a time frame during which the trigger will operate.
- 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.
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.
- Starting (UTC) - Select the start date and time for the scheduled trigger.
- Recur every - Choose the time interval for triggering and checking time off requests. The minimum time interval is 15 minutes.
- Add time frame - You can specify a time frame during which the trigger will operate.
- 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.
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.
- Starting (UTC) - Select the start date and time for the scheduled trigger.
- Recur every - Choose the time interval for triggering and checking time off. The minimum time interval is 15 minutes.
- Add time frame - You can specify a time frame during which the trigger will operate.
- 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.
Check for Updated Employees
Starts the workflow when employee records are changed in BambooHR. Engini checks BambooHR on the schedule you set.
- Starting (UTC) - Select the start date and time for the scheduled trigger.
- Recur every - Choose the time interval for triggering and checking employees. The minimum time interval is 15 minutes.
- Add time frame - You can specify a time frame during which the trigger will operate.
- 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.
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.
- Name - Enter a name for the webhook that BambooHR will use to notify Engini, for example “New employee alert”.
- 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). - 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.
Actions
Add Employee
Creates a new employee record in BambooHR.
- First Name - Enter the employee’s first name, for example “Jane”.
- Last Name - Enter the employee’s last name, for example “Smith”.
- 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.
- 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.
- Status - Select the new status: Approved, Cancelled or Denied (or declined).
- 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.
- 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.
- 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.
- Start - Enter the first day of the range in the format YYYY-MM-DD, for example
2026-11-01. - End - Enter the last day of the range in the format YYYY-MM-DD, for example
2026-11-14. - 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.
- Since - Enter the date and time to start checking from, in the format
2026-01-01T00:00:00Z. The Z means UTC time. - 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.
- 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.
- 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.
- Employee Id - Select the employee from the list, or map an Employee Id from an earlier step, for example Get Employees.
- Only Current - Enter True to return only the employee’s current information, or False to include historical values. The default is False.
Get Employee Files and Categories
Retrieves all the files of an employee together with their categories.
- 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.
Get Time Off Requests
Retrieves the time off requests within a date range.
- Start - Enter the first day of the range in the format YYYY-MM-DD, for example
2026-11-01. - End - Enter the last day of the range in the format YYYY-MM-DD, for example
2026-11-30. - 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.
Request a Custom Report
Generates a custom BambooHR report in the format you choose.
- Format - Select the output format of the report: CSV, PDF, XLS, XML or JSON.
- 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
Updates the details of an existing employee.
- 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.
- First Name - Enter the employee’s new first name, for example “Jane”.
- Last Name - Enter the employee’s new last name, for example “Smith”.
- 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.
- 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.
- 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.
- Name - Enter the new name for the file, for example
contract.pdf. - 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.
- 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.
- 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.
- 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.
- File Name - Enter the name the file gets in BambooHR, for example
contract.pdf. - Share - Select Yes to let the employee see the file, or No to keep it hidden from them.
- 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.
- Base Url - The root URL of the BambooHR API. It is filled in from your BambooHR connection and can’t be edited here.
- 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.
- Method - Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
- 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-Typerow in Add Headers with the media type you need (for exampleapplication/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 underheadersnotsent. - 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.
- Body - Contains any data that is being sent to the server.
- 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.
- 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.