--- title: "BambooHR — IT Setup Guide" description: "One-time setup steps to connect BambooHR to SIA" canonical_url: https://senseloaf.guides.markdrop.in/integrations/bamboohr-it-setup-guide last_updated: 2026-11-01 site: "Senseloaf" index: https://senseloaf.guides.markdrop.in/llms.txt --- # BambooHR — IT Setup Guide This guide is for IT administrators and BambooHR account owners. It covers generating an API key, connecting BambooHR to SIA, and optionally configuring candidate stages for automated syncing. Once setup is complete, your HR team can start using SIA's hiring intelligence directly from BambooHR — see the BambooHR HR Workflow Guide for what they can do from there. > **Warning** > > **Note:** Connecting BambooHR to SIA connects it for your **entire organisation**, not just your account. Disconnecting it later turns it off for everyone — confirm with your team before switching connectors. SIA only keeps one ATS active at a time. ### Before you begin To connect BambooHR to SIA, you'll need to complete two steps — and optionally a third: 1. Generate an API key in BambooHR 2. Connect BambooHR in the SIA Connectors page 3. Configure candidate stages for automated syncing *(optional)* ### Step 1 — Generate an API key in BambooHR Authentication with BambooHR is done through an API key, generated from your own account settings. > **Danger** > > API keys carry **full user permissions** and **never expire** — they're intended for internal integration use. Store the key securely and share it only with your Senseloaf admin. **A. Open your API Keys page** ![BambooHR Admin menu — Profile → API Keys](https://senseloaf.guides.markdrop.in/docs-assets/import/integrations/bamboohr-it-setup-guide/bamboohr-admin-menu-profile-api-keys.png) 1. Log in to your BambooHR account 2. Click **My Account** in the bottom-left corner of the sidebar 3. Click **API Keys** from the menu that appears **B. Start a new key** ![Add New Key](https://senseloaf.guides.markdrop.in/docs-assets/import/integrations/bamboohr-it-setup-guide/add-new-key.png) 1. On the API Keys page, click **New API Key** 2. A dialog opens confirming that API keys carry full user permissions and never expire **C. Name and create the key** ![Name and Create the Key](https://senseloaf.guides.markdrop.in/docs-assets/import/integrations/bamboohr-it-setup-guide/name-and-create-the-key.png) 1. Enter a descriptive name for the API key — for example, *Senseloaf*. This helps you identify where the key is being used 2. Click **Create Key** **D. Copy and store the key** ![Copy and Store the Key](https://senseloaf.guides.markdrop.in/docs-assets/import/integrations/bamboohr-it-setup-guide/copy-and-store-the-key@1x.png) 1. BambooHR shows a confirmation with your new key and a **Copy Key** button 2. Click **Copy Key** and store it securely, then click **Close** > **Danger** > > **Important:** This is the only time the full API key will be visible. You will not be able to retrieve it again later. If you lose it, you'll need to generate a new one. Your key will appear in the **My API Keys** list marked as Enabled. ### Step 2 — Configure candidate stages in BambooHR *(optional)* This step is only needed if you want to enable automated bidirectional sync, where candidate stages in BambooHR update automatically based on their SIA evaluation results at each step of the hiring workflow. You don't necessarily need to create new stages for this. If you already have stages in BambooHR that correspond to your hiring workflow, those can be mapped directly during Senseloaf onboarding. Only create new stages if your existing ones don't cover the outcomes you need. > **Danger** > > Only users with administrative access to hiring settings can perform these steps. **Creating new custom stages** 1. Click the **gear icon** (Settings) in the upper right corner of your BambooHR dashboard 2. Select **Hiring** from the left-hand menu 3. Navigate to the **Candidate Status** section 4. Click **Add Status** or the **+** icon 5. Enter a descriptive name for the stage — for example, *AI Matching – Strong Fit*, *AI Matching – Review*, *AI Prescreening – Qualified*, or *AI Interview – Selected* 6. Optionally link an email template to automatically notify candidates when they reach this stage 7. Drag and drop statuses to match the chronological order of your hiring pipeline 8. Click **Save** to apply Once the relevant stages exist in BambooHR, they can be mapped to SIA evaluation outcomes during onboarding. Based on a candidate's score at each step — AI Matching, AI Prescreening, and AI Interview — SIA can automatically move them to the corresponding stage. > **Note** > > **Note:** Stage names can be customised to match your team's existing naming conventions. What matters is that the stages exist in BambooHR before the mapping is configured in Senseloaf. **Enable automatic syncing** To enable bidirectional sync between BambooHR and SIA, reach out to the Senseloaf team at . The team will configure and enable the required synchronisation for your organisation. Once automatic syncing is enabled, your BambooHR hiring data will be synchronised with SIA, allowing your team to use SIA's AI-powered hiring capabilities while continuing to manage their hiring workflow in BambooHR. ### Step 3 — Connect BambooHR in SIA Once you have your BambooHR API key, you can connect BambooHR to SIA. [Video: Connecting BambooHR](https://senseloaf.guides.markdrop.in/docs-assets/import/integrations/bamboohr-it-setup-guide/connecting-bamboohr.mp4) **A. Open Connectors in SIA** 1. Log in to your SIA account 2. Click your **Profile icon** in the bottom-left corner 3. Click **Connectors** from the menu 4. On the Connectors page, find **BambooHR** under the ATS section and click **Connect** — this opens the Connect BambooHR pop-up > **Warning** > > **Note:** The pop-up includes a "Steps to get your API key" link back to this guide in case you need to refer back to Step 1. **B. Enter your BambooHR credentials** * **BambooHR API Key** — paste the API key generated in Step 1 * **Subdomain** — enter your BambooHR company subdomain For example, if your BambooHR URL is `https://senseloaf.bamboohr.com/home`, your subdomain is `senseloaf` * **API Base URL** *(optional)* — leave this blank unless directed otherwise by the Senseloaf team **C. Complete the connection** 1. Verify the API key and subdomain are correct 2. Click **Connect** 3. SIA establishes the connection — the BambooHR tile will show as **Connected** with a **Disconnect** option > **Warning** > > **Note:** If your organisation already has another ATS connected, the tile will show a **Switch** option instead of Connect — SIA only keeps one ATS active at a time. ### What happens once connected Once BambooHR is connected, SIA begins syncing jobs and candidates automatically — no further setup required from IT. For a full overview of what the HR team can do from here, see the BambooHR HR Workflow Guide.