# BambooHR integration

{% hint style="info" %}
If you’re new to integrations in Rewst, read through our introductory integration documentation [here](https://docs.rewst.help/documentation/integrations).v
{% endhint %}

## **What does the BambooHR integration do?**

Our BambooHR integration enables data synchronization and automation in HR processes. Use BambooHR's API within Rewst workflows to automate HR workflows, manage employee records, and synchronize relevant HR data securely across platforms.

## Set up the BambooHR integration

### Set up steps in BambooHR

1. Log in to BambooHR. 
2. Navigate to https\://{INSERT COMPANY DOMAIN HERE}.bamboohr.com
3. **Generate new API token.** On the top right corner, click on the settings cog icon. Click API Keys. Add a new key.
4. **Copy the token value.** The token value will be displayed in the lower right corner. Copy the token value to your clipboard. You will need this value to authenticate your API calls.

### Set up steps in Rewst

1. Navigate to **Marketplace > Integrations** in the left side menu of your Rewst platform.
2. Search for `BambooHR` in the integrations page.\
   \
   ![](https://1835401289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQQ1EHVcEsGKBPVHmiav%2Fuploads%2F9mrc3OZvcKEtJOXPupcM%2FScreenshot%202025-05-01%20at%204.48.56%E2%80%AFPM.png?alt=media\&token=893d1e9d-ea64-4d19-a7c8-3602dba58d41)
3. Click on the integration tile to launch the configuration setup page.
4. Under **Parameters**:
   1. Paste the API token into the **API token** field.
   2.  Enter the company domain from your BambooHR account. E.g. If you navigate to `https://example.bamboohr.com`, your company domain is `example`.
5. Click **Save Configuration**.

{% hint style="info" %}
The BambooHR integration does not require you to complete the organization mapping process.
{% endhint %}

{% hint style="success" %}
Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our [Canny feedback collector](https://rewst.canny.io/integrations).
{% endhint %}

## Actions and endpoints

{% hint style="info" %}
For more on how actions work in Rewst, check out our [introductory actions documentation here](https://docs.rewst.help/documentation/workflows/actions-in-rewst). 
{% endhint %}

| Category                | Action                  | Description                                                                    |
| ----------------------- | ----------------------- | ------------------------------------------------------------------------------ |
| **Account Information** | List Fields             | Get a list of fields that are available in the account                         |
| **Employees**           | Get Company Information | Gets Company Information                                                       |
| **Employees**           | Get Employee            | Get employee data by specifying a set of fields.                               |
| **Employees**           | Update Employee         | Update an employee, based on employee ID                                       |
| **Employees**           | Add Employee            | Add an employee. New employees must have at least a first name and a last name |
| **Employees**           | Get Employee Directory  | Gets Employee Directory                                                        |
| **Generic Request**     | BambooHR API Request    | Generic action for making authenticated requests against the BambooHR API      |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rewst.help/documentation/integrations/integration-guides/bamboohr-integration-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.