---
title: BambooHR modules
slug: bamboohr-modules
createdAt: 2025-11-26T10:51:31.796Z
---

After connecting to the BambooHR app, you can use the following modules to build your scenarios.&#x20;

## Employees

### Watch Employees

Watches for added employees.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Limit**      | Set the maximum number of employees Make should return during one execution cycle.                      |

:::hint{type="success"}
After filling in the required fields, you will be asked to choose where to start. If you select **Choose manually**, the result list will always show the first 500 results. Therefore, it is necessary to select **Since specific ID**.
:::

### Watch Updated Employees

Watches for newly updated employees.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Since**      | Indicate a date since which you want to watch updates made to employees.                                |
| **Type**       | Select the type of update you want to watch.                                                            |
| **Limit**      | Set the maximum number of updated employees Make should return during one execution cycle.              |

:::hint{type="success"}
After filling in the required fields, you will be asked to choose where to start. If you select **Choose manually**, the result list will always show the first 500 results. Therefore, it is necessary to select **Since specific ID**.
:::

### List Employees

Returns a list of employees.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Limit**      | Set the maximum number of employees Make should return during one execution cycle.                      |

### List Updated Employees

Lists all updated employees since a specified date.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Since**      | Indicate a date since which you want to list updates made to employees.                                 |
| **Type**       | Select the type of update you want to list.                                                             |
| **Limit**      | Set the maximum number of updated employees Make should return during one execution cycle.              |

### Request a Custom Report

Requests a custom report that includes employees.

| **Connection**             | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Only current employees** | Select or map if you want to include data of future-dated employees to a custom report.                 |
| **Fields**                 | Select or map fields of the custom report you want to get.                                              |
| **Limit**                  | Set the maximum number of custom reports Make should return during one execution cycle.                 |

### Get an Employee

Returns employee data by specifying a set of fields.

| **Connection**  | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Employee ID** | Select or map the Employee ID whose details you want to retrieve.                                       |
| **Fields**      | Select or map the fields you want to include in the employee details.                                   |

### Create an Employee

Adds a new employee.

| **Connection**               | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and)                                          |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Synced with Trax Payroll** | Select whether you want to create a Trax payroll employee.                                                                                       |
| **First Name**               | Enter (map) the employee's first name.                                                                                                           |
| **Last Name**                | Enter (map) the employee's last name.                                                                                                            |
| **Employee Number**          | Enter (map) the employee's number.                                                                                                               |
| **Date of Birth**            | Enter the employee's date of birth.                                                                                                              |
| **SSN**                      | Enter the employee's social security number.                                                                                                     |
| **Gender**                   | Select or map the employee's gender. For example, `male`.                                                                                        |
| **Marital Status**           | Select or map the employee's marital status. For example, `Single`.                                                                              |
| **Hire Date**                | Enter the date on which the employee was hired for the job.                                                                                      |
| **Address**                  | Enter the employee's address.                                                                                                                    |
| **City**                     | Enter the city name.                                                                                                                             |
| **State**                    | Enter the state name.                                                                                                                            |
| **Country**                  | Enter the country name.                                                                                                                          |
| **Employment Status**        | Select or map the employment status of the employee.                                                                                             |
| **Exempt**                   | Select whether the employee is exempted from taxes.                                                                                              |
| **Pay Type**                 | Select or map the employee pay type. For example, `hourly`, `weekly`.                                                                            |
| **Pay Rate**                 | Select or map the employee pay rate in US Dollars. For example, if you have selected `Pay Type` as hourly then enter the employee's hourly rate. |
| **Pay Per**                  | Select or map the frequency of payment to the employee. For example, `Monthly`.                                                                  |
| **Location**                 | Select or map the employee location.                                                                                                             |
| **Department**               | Select or map the department to which the employee belongs to. For example, `Human Resources`.                                                   |
| **Division**                 | Enter (map) the division to which the employee belongs to. For example, `Europe`.                                                                |

### Update an Employee

Updates a specified employee.

| **Connection**               | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and)                                        |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Employee ID**              | Select or map the Employee ID whose details you want to update.                                                                                |
| **Synced with Trax Payroll** | Select whether you want to create a Trax payroll employee.                                                                                     |
| **First Name**               | Enter (map) the employee's first name.                                                                                                         |
| **Last Name**                | Enter (map) the employee's last name.                                                                                                          |
| **Employee Number**          | Enter (map) the employee's number.                                                                                                             |
| **Date of Birth**            | Enter the employee's date of birth.                                                                                                            |
| **SSN**                      | Enter the employee's social security number.                                                                                                   |
| **Gender**                   | Select or map the employee's gender. For example, `male`.                                                                                      |
| **Marital Status**           | Select or map the employee's marital status. For example, `Single`.                                                                            |
| **Hire Date**                | Enter the date on which the employee was hired for the job.                                                                                    |
| **Address**                  | Enter the employee's address.                                                                                                                  |
| **City**                     | Enter the city name.                                                                                                                           |
| **State**                    | Enter the state name.                                                                                                                          |
| **Country**                  | Enter the country name.                                                                                                                        |
| **Employment Status**        | Select or map the employment status of the employee.                                                                                           |
| **Exempt**                   | Select whether the employee is exempted from taxes.                                                                                            |
| **Pay Type**                 | Select or map the employee pay type. For example, `hourly`, `weekly`.                                                                          |
| **Pay Rate**                 | Select or map the employee pay rate in US Dollars. For example, if you have selected pay type as hourly then enter the employee's hourly rate. |
| **Pay Per**                  | Select or map the period of payment to the employee. For example, `Monthly`.                                                                   |
| **Location**                 | Select or map the employee location.                                                                                                           |
| **Department**               | Select or map the department to which the employee belongs to. For example, `Human Resources`.                                                 |
| **Division**                 | Enter (map) the division to which the employee belongs. For example, `Europe`.                                                                 |

## Employee Files

### List Employee Files

Returns a list of employee files.

| **Connection**  | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Employee ID** | Select or map the Employee ID whose files you want to list.                                             |
| **Limit**       | Set the maximum number of files Make should return during one execution cycle.                          |

### Download an Employee File

Returns a specified employee file.

| **Connection**  | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Employee ID** | Select or map the Employee ID whose files you want to download.                                         |
| **File ID**     | Select or map the File ID you want to download.                                                         |

### Upload an Employee File

Creates an employee file.

| **Connection**          | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| ----------------------- | ------------------------------------------------------------------------------------------------------- |
| **Employee ID**         | Select or map the Employee ID whose files you want to list.                                             |
| **File Name**           | Enter the file name including the file extension. For example, *test.txt*                               |
| **File**                | Enter or map the file data.                                                                             |
| **Share with Employee** | Select the checkbox if you want to share the file with an employee.                                     |

### Update an Employee File

Updates a specified employee file.

| **Connection**          | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| ----------------------- | ------------------------------------------------------------------------------------------------------- |
| **Employee ID**         | Select or map the Employee ID whose file you want to update.                                            |
| **File ID**             | Select or map the File ID whose details you want to update.                                             |
| **Share with Employee** | Select the checkbox if you want to share the file with an employee.                                     |
| **Category ID**         | Select or map the Category ID to which the file belongs to.                                             |
| **Name**                | Enter a new name for the file.                                                                          |

### Delete an Employee File

Deletes a specified employee file.

| **Connection**  | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Employee ID** | Select or map the Employee ID whose file you want to delete.                                            |
| **File ID**     | Select or map the File ID whose details you want to delete.                                             |

## Time Offs

### Watch Time Offs

Watches for newly created time-offs for the specified time boundaries.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Start Time** | Enter (map) the start time to watch the time-offs that match the specified time.                        |
| **End Time**   | Enter (map) the end time to watch the time-offs that match the specified time.                          |
| **Limit**      | Set the maximum number of time-offs Make should return during one execution cycle.                      |

### Get Summary of Who's Out

Returns a list, sorted by date of employees who will be out and company holidays for a period of time.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and)  |
| -------------- | -------------------------------------------------------------------------------------------------------- |
| **Start Time** | Enter (map) the start time of the employee off or holiday whose details you want to retrieve.            |
| **End Time**   | Enter (map) the end time of the employee off or holiday whose details you want to retrieve.              |
| **Limit**      | Set the maximum number of employee time offs or holidays Make should return during one execution cycle.  |

## Time Off Requests

### Watch Time Off Requests

Watches for newly created time off requests which can be approved by you.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Start Time** | Enter (map) the start time to watch the time-off requests that start on or after the specified time.    |
| **End Time**   | Enter (map) the end time to watch the time-off requests that end on or before the specified time.       |
| **Limit**      | Set the maximum number of time-off requests Make should return during one execution cycle.              |

### Search Time Off Requests

Returns a list of time off requests with specified options.

| **Connection**          | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and)                                |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Start Time**          | Enter (map) the start time to search the time-off requests that start on or after the specified time.                                  |
| **End Time**            | Enter (map) the end time to search the time-off requests that end on or after the specified time.                                      |
| **Time Off Request ID** | Select or map the Time-off Request ID whose details you want to search.                                                                |
| **Action**              | Select or map the time-off requests access to search only the requests that match the specified action:<br />- *View*<br />- *Approve* |
| **Employee ID**         | Select or map the Employee ID to search the specified employee time-off requests.                                                      |
| **Type**                | Select the time-off request type to search only the request that matches the specified type. For example, `Bereavement`.               |
| **Status**              | Select the status of the time-off request to search only the request that matches the specified status. For example, `Approved`.       |
| **Limit**               | Set the maximum number of time-off requests Make should return during one execution cycle.                                             |

### Change a Time Off Request Status

Changes the status of a time-off request in the system. You can use this to approve or deny, or cancel a time-off request.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and)               |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Request ID** | Select or map the Request ID whose status you want to change.                                                         |
| **Status**     | Select or map the status to which you want to update the request:<br />- *Approved*<br />- *Denied*<br />- *Canceled* |
| **Note**       | Enter the details for updating the request status.                                                                    |

## Jobs

### Watch Job Summaries

Watches for newly created job summaries.

| **Connection** | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and) |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| **Limit**      | Set the maximum number of job summaries Make should return during one execution cycle.                  |
| **Status**     | Select the status of job summaries that you want to watch.                                              |

## Other

### Make an API Call

Performs an arbitrary authorized API call.

| **Connection**   | [Establish a connection to your BambooHR account.](https://apps.make.com/bamboohr#connect-bamboohr-and)                                                                                                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **URL**          | Enter a path relative to `https://api.bamboohr.com/api/gateway.php/<domain>`. For example: `/v1/meta/fields`.<br />Note: For the list of available endpoints, refer to the [BambooHR API Documentation](https://www.bamboohr.com/api/documentation/).                                                  |
| **Method**       | Select the HTTP method you want to use:<br />**GET**<br />to retrieve information for an entr&#x79;**.**<br />**POST**<br />to create a new entry.<br />**PUT**<br />to update/replace an existing entry.<br />**PATCH**<br />to make a partial entry update.<br />**DELETE**<br />to delete an entry. |
| **Headers**      | Enter the desired request headers. You don't have to add authorization headers; we've already done that for you.                                                                                                                                                                                       |
| **Query String** | Enter the request query string.                                                                                                                                                                                                                                                                        |
| **Body**         | Enter the body content for your API call.                                                                                                                                                                                                                                                              |

:::hint{type="success"}
For the list of available endpoints, refer to the [BambooHR API Documentation](https://www.bamboohr.com/api/documentation/).
:::

## Example of Use - List Company File Categories

The following API call returns all the company file categories from your BambooHR account:

**URL**:

`/v1/files/view`

**Method**:

`GET`

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/cNSV8XkQn7Ba-pu5winXG_uuid-9e439388-9f24-a3f2-fb3f-e4e5bb9c639f.png" size="50" width="489" height="1050" position="center" darkWidth="489" darkHeight="1050" showCaption="false"}

Matches of the search can be found in the module's **Output** under *Bundle* > *Body > Categories.*

In our example, 3 categories were returned:

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/3nL0hjrWBqeBeyRlwjwSu_uuid-546fe9a3-9283-0be5-dde7-93c6776d67ef.png" size="50" width="494" height="627" position="center" darkWidth="494" darkHeight="627" showCaption="false"}

