# BambooHR

BambooHR Integration Guide

## Introduction <a href="#introduction" id="introduction"></a>

BambooHR is an American technology company that provides human resources software as a service. Founded in 2008 by Ben Peterson and Ryan Sanders, the company is based in Lindon, Utah.

## Available Features

* User Inventory
* Identity Rules

## Prerequisites <a href="#prerequisites" id="prerequisites"></a>

The BambooHR account should be a user account with Manager Role or a Service Account with Manager Role.

<details>

<summary><strong>Follow these steps to generate the API Key :</strong></summary>

1 Login to **BambooHR** using the account that was assigned the required scopes.\
2 Go to right top avatar -> API Keys\
3 Click "Add New Key".\
4 Add a label in "API Key Name" field and click "Generate Key".\
5 Hit copy to copy the API Key.

</details>

## Onboarding BambooHR in your Perimeters account <a href="#onboarding-entraid-in-your-perimeters-account" id="onboarding-entraid-in-your-perimeters-account"></a>

1. Go to "Integrations" -> Select "BambooHR" -> Click "+ Add" -> Click "+ Start Integration".
2. **"Namespace" -**\
   To get your BambooHR account namespace:\
   1 Login to BambooHR Account.\
   2 Once logged in, Check the browser address bar for namespace.(Ex. <https://example.bamboohr.com)\\>
   3 Extract the namespace from the URL, which is the portion of the URL preceding bamboohr.com.\
   For instance, if your account's URL is **'<https://example.bamboohr.com>'**, your namespace would be **'example'**.\
   Please enter the extracted namespace in this Namespace field. Click **'Next'** to proceed.
3. **"API Key" -**\
   Copy the API key you previously created from your BambooHR account page and paste it here.
4. Click **"Finish"** to complete the onboarding process.

Once you have completed these steps, BambooHR should be successfully integrated with your Perimeters account.


---

# 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://support.perimeters.io/perimeters-documentation/connecting-perimeters/integrations-for-security-insights/saas-applications/bamboohr.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.