> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the BambooHR Templates

[Back to Actions Integrations](https://koreai.mintlify.site/ai-for-service/integrations/overview.md#actions)

Use prebuilt BambooHR action templates to auto-create dialog tasks.

**Prerequisites:** Configure [BambooHR](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action) and [install templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates) before proceeding.

Navigate to **Automation AI > Use Cases > Dialogs**, then click the auto-created dialog to open the canvas.

***

## Supported Actions

| Action | Description | Method |
| - | - | - |
| Create an Employee | Creates an employee in BambooHR | POST |
| Get Employee by ID | Finds an employee by ID | GET |
| List All Employees | Retrieves all employees | GET |
| Update an Employee | Updates employee details | POST |
| Get All Time Off Requests | Retrieves all time off requests | GET |
| Get a List of Who is Out | Lists employees who are out | GET |
| Update a Request Status | Updates a time off request status | POST |

***

## Create an Employee

1. Install the template from [BambooHR Templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates).

2. The **Create an Employee** dialog task is added with:

   ![Create Employee dialog task](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img4-create-employee.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=505ee49023e1dbe20c0d54933fc2cd0f)

   * **createEmployee** - User intent to create an employee.

   * **companyDomain**, **firstName**, **lastName** - Entity nodes for employee details.

   * **createEmployeeService** - Bot action service to create the employee. Click **Edit Request**:

     ![Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img5-create-employee.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=30c4463d234c5e3b14d97c91933bf746)

     **Sample Request:**

     ```json theme={null}
     {
       "firstName": "Alen",
       "lastName": "walker"
     }
     ```

   * **createEmployeeMessage** - Message node to display the result.

3. Click **Train**, then **Talk to Bot** to test.

4. Follow the prompts to create an employee.

   ![Employee creation](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img6-create-employee1.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=6223b136df097e8d9c95fbb1f1495a02)

5. Click **View Employee** to view employee details in BambooHR.

   ![Employee details](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img7-create-employee2.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=d81b5bf7e19794332beee1465efbae75)

***

## Get Employee by ID

1. Install the template from [BambooHR Templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates).

2. The **Get Employee by ID** dialog task is added with:

   ![Get Employee ID task](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img8-get-employee.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=5e072be86bb2dc923082b1c670f2b1e1)

   * **getEmployeeByID** - User intent to find an employee by ID.

   * **companyDomain** and **id** - Entity nodes for employee details.

   * **getEmployeeByIdService** - Bot action service to fetch the employee. Click **Edit Request**:

     ![Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img9-get-employee1.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=97b01c6d6dd5d57e1f3173e390187483)

     **Sample Request:**

     ```json theme={null}
     {
       "id": "114",
       "firstName": "Alen",
       "lastName": "walker"
     }
     ```

   * **getEmployeeMessage** - Message node to display the result.

3. Click **Train**, then **Talk to Bot** to test.

4. Follow the prompts to find the employee.

   ![Find employee](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img10-get-employee2.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=23a154c4191c30b7eb4eca39127082e4)

5. Click **View Employee** to view details in BambooHR.

***

## List All Employees

1. Install the template from [BambooHR Templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates).

2. The **List All Employees** dialog task is added with:

   ![List all employees](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img11-list-employees.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=a551a138b8685743630cb64f6e166168)

   * **listAllEmployees** - User intent to list employees.

   * **companyDomain** - Entity node for the company domain.

   * **listAllEmployeesService** - Bot action service to fetch all employees. Click **Edit Request**:

     ![Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img12-list-employees1.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=831e3a598f2124a9461d13eb68684ab0)

     **Sample Request:**

     ```json theme={null}
     {
       "fields": ["firstName", "lastName"]
     }
     ```

     **Sample Response:**

     ```json theme={null}
     {
       "title": "Report",
       "fields": [
         { "id": "firstName", "type": "text", "name": "First Name" },
         { "id": "lastName", "type": "text", "name": "Last Name" }
       ],
       "employees": [
         { "id": "112", "firstName": "John", "lastName": "Doe" },
         { "id": "113", "firstName": "Harry", "lastName": "Anthony" },
         { "id": "114", "firstName": "Alen", "lastName": "walker" }
       ]
     }
     ```

   * **listAllEmployeesMessage** - Message node to display results.

3. Click **Talk to Bot** to test.

4. Follow the prompts to view employees.

   ![List employees](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img13-list-employees2.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=4ccf0a88292467b1adc3c90cb7bd031e)

***

## Update an Employee

1. Install the template from [BambooHR Templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates).

2. The **Update an Employee** dialog task is added with:

   ![Update Employee dialog task](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img14-update-employee.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=f58b63de0614e0e9c7041e4487bb54cf)

   * **updateEmployee** - User intent to update an employee.

   * **companyDomain**, **id**, **chooseField**, **firstName**, **lastName** - Entity nodes.

   * **updateEmployeeScript** - Bot action script to prepare the update.

     ![View component properties](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img15-update-employee1.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=e1a5fa48d9bdcf7b5b67616d5e5805ff)

   * **updateEmployeeService** - Bot action service to update the employee. Click **Edit Request**:

     ![Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img16-update-employee2.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=88eb2a9a77761fe9306b04ce5ae2f8a7)

     **Sample Request:**

     ```json theme={null}
     {
       "firstName": "Alen",
       "lastName": "walker"
     }
     ```

   * **getEmployeeByIdService** - Bot action service to fetch the updated employee by ID.

   * **updateEmployeeMessage** - Message node to display the result.

3. Click **Talk to Bot** to test.

4. Follow the prompts to update the employee.

   ![Update employee](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img17-update-employee3.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=ca22207fdbb5409bd785348b66836c5d)

5. Click **View Employee** to view details in BambooHR.

***

## Get All Time Off Requests

1. Install the template from [BambooHR Templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates).

2. The **Get All Time Off Requests** dialog task is added with:

   ![Get Time Off Request dialog](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img18-get-time-off.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=c7ba4bbf85cedd9fc9215135f823d80c)

   * **getTimeoffRequests** - User intent to get time off requests.

   * **companyDomain**, **startDate**, **endDate** - Entity nodes for the request range.

   * **getTimeoffRequestsService** - Bot action service to fetch time off requests. Click **Edit Request**:

     ![Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img19-get-time-off1.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=93070b967abb2910311f354320b448ba)

     **Sample Response:**

     ```json theme={null}
     [
       {
         "id": "1649",
         "employeeId": "112",
         "status": { "lastChanged": "2022-12-22", "status": "approved" },
         "name": "Mark Anderson",
         "start": "2022-12-14",
         "end": "2022-12-15",
         "type": { "id": "83", "name": "Vacation" },
         "amount": { "unit": "hours", "amount": "16" }
       }
     ]
     ```

   * **getTimeoffRequestsMessage** - Message node to display results.

3. Click **Talk to Bot** to test.

4. Follow the prompts.

   ![Get all time off requests](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img20-get-time-off2.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=29b21f645cada52f0c54bc80dc20a640)

***

## Get a List of Who is Out

1. Install the template from [BambooHR Templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates).

2. The **Get a List of Who Is Out** dialog task is added with:

   ![Who is Out dialog task](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img21-get-who-out.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=fca100523545f84275dec7b1046eaacb)

   * **getListWhoisOut** - User intent to list who is out.

   * **companyDomain** - Entity node for the company domain.

   * **getListWhoOutService** - Bot action service to get the list. Click **Edit Request**:

     ![Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img22-get-who-out.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=e391de3a90633dde83ae68c98186e31a)

   * **getListWhoIsOutMessage** - Message node to display results.

3. Click **Talk to Bot** to test.

4. Follow the prompts.

***

## Update a Request Status

1. Install the template from [BambooHR Templates](https://koreai.mintlify.site/ai-for-service/integrations/actions/configuring-the-bamboohr-action#step-2-install-bamboohr-action-templates).

2. The **Update a Request Status** dialog task is added with:

   ![Update Request Status dialog task](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img23-update-request-status.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=2a86ae24da94687888f7e7d223e43a17)

   * **updateRequestStatus** - User intent to update a request.

   * **companyDomain**, **requestID**, **requestStatus** - Entity nodes.

   * **updateRequestStatusScript** - Bot action script to prepare the update.

     ![Update Request Status script](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img24-update-request-status.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=25266dda54f491b424c3ed56078aeb18)

   * **updateRequestStatusService** - Bot action service to update the request. Click **Edit Request**:

     ![Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img25-update-request-status.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=23a16833abdac883fe35c9a86f963ac4)

     **Sample Request:**

     ```json theme={null}
     {
       "status": "approved",
       "note": "Have fun!"
     }
     ```

   * **updateRequestStatusMessage** - Message node to display the result.

3. Click **Talk to Bot** to test.

4. Follow the prompts.

   ![Update Request](https://mintcdn.com/koreai/7TeKpNFD7QJEMcMu/ai-for-service/integrations/actions/images/bamboo-hr-tem-img26-update-request-status.png?fit=max\&auto=format\&n=7TeKpNFD7QJEMcMu\&q=85\&s=87931b138ef4d591b612245fa80689e3)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.