> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BambooHR

> Keep email signatures accurate and automatically up to date by syncing employee details from BambooHR, your HR system, like name, job title, and custom fields.

Follow these steps to [auto-fill your teammate's signatures](/en/smart-fields) using BambooHR as a data source.

<Info>
  **No action needed from your teammates.**
</Info>

<Info>
  **Changes in your BambooHR auto-sync to Scribe.**
</Info>

<Info>
  **SOC 2 Type II Certified.** [Your data is safe](/en/security/data-collection/bamboohr).
</Info>

## Installation guide

### Prerequisites

* A Scribe account with admin access
* A BambooHR account with API key access

<Steps>
  <Step title="Go to your BambooHR account and copy the instance subdomain from the URL bar">
    Your subdomain is the part before `.bamboohr.com` in your BambooHR URL. Enter it in the **Subdomain** field in Scribe.

    <Frame>
      <img src="https://mintcdn.com/scribe/I5V9iTucPI_EY3nq/integrations/smart-fields/images/bamboohr-step-1.png?fit=max&auto=format&n=I5V9iTucPI_EY3nq&q=85&s=f9fb00e815331693135a27776c1b62b1" alt="BambooHR subdomain in URL bar" className="mx-auto" style={{ width:"80%" }} width="922" height="152" data-path="integrations/smart-fields/images/bamboohr-step-1.png" />
    </Frame>
  </Step>

  <Step title="In your BambooHR account, click your profile picture, then click API Keys">
    <Frame>
      <img src="https://mintcdn.com/scribe/I5V9iTucPI_EY3nq/integrations/smart-fields/images/bamboohr-step-2.png?fit=max&auto=format&n=I5V9iTucPI_EY3nq&q=85&s=3b3ea5b147a464b14057732c520e3661" alt="BambooHR profile menu with API Keys option" className="mx-auto" style={{ width:"51%" }} width="790" height="928" data-path="integrations/smart-fields/images/bamboohr-step-2.png" />
    </Frame>
  </Step>

  <Step title="Click Add New Key">
    <Frame>
      <img src="https://mintcdn.com/scribe/I5V9iTucPI_EY3nq/integrations/smart-fields/images/bamboohr-step-3.png?fit=max&auto=format&n=I5V9iTucPI_EY3nq&q=85&s=9ea6c76c8dc61421505fe3e64944ecf9" alt="My API Keys page with Add New Key button" className="mx-auto" style={{ width:"76%" }} width="2458" height="690" data-path="integrations/smart-fields/images/bamboohr-step-3.png" />
    </Frame>
  </Step>

  <Step title="Enter a name for your API key, then click Generate Key">
    You can name the key anything you want (e.g. "Scribe"). It's just a way for you to keep track of your API keys.

    <Frame>
      <img src="https://mintcdn.com/scribe/I5V9iTucPI_EY3nq/integrations/smart-fields/images/bamboohr-step-4.png?fit=max&auto=format&n=I5V9iTucPI_EY3nq&q=85&s=20524dcc449b4c6c0d9b5a145f671a3d" alt="Add New API Key dialog with name field and Generate Key button" className="mx-auto" style={{ width:"71%" }} width="1316" height="740" data-path="integrations/smart-fields/images/bamboohr-step-4.png" />
    </Frame>
  </Step>

  <Step title="Copy the generated API key and paste it into the BambooHR API key field in Scribe, then click &#x22;Done&#x22;">
    <Frame>
      <img src="https://mintcdn.com/scribe/I5V9iTucPI_EY3nq/integrations/smart-fields/images/bamboohr-step-5.png?fit=max&auto=format&n=I5V9iTucPI_EY3nq&q=85&s=0ab4f978b68d727c64e854164b4d0c20" alt="Generated API key with Copy Key and Done buttons" className="mx-auto" style={{ width:"75%" }} width="1272" height="904" data-path="integrations/smart-fields/images/bamboohr-step-5.png" />
    </Frame>
  </Step>

  <Step title="Optionally, you can customize your integration with a report ID.">
    The default BambooHR integration provides access to basic Smartfields such as first name, last name, etc.

    If you need additional Smartfields, including custom fields you've created in BambooHR, you'll need to generate a custom report within BambooHR and enter the report ID into your Scribe integration.

    <Warning>
      The "work email" field must be included in the BambooHR report to ensure we can correctly match your BambooHR employees with your Scribe teammates.
    </Warning>

    Enter your report ID, then click **Connect BambooHR**.

    <Frame>
      <img src="https://mintcdn.com/scribe/Z_G2D9X-Tlrxu_Eh/images/bamboohr-connect-integration-report-id.png?fit=max&auto=format&n=Z_G2D9X-Tlrxu_Eh&q=85&s=93c479407091642dfd7ced1de0c49b83" alt="BambooHR report ID field and Connect BambooHR button in Scribe" width="3456" height="1926" data-path="images/bamboohr-connect-integration-report-id.png" />
    </Frame>
  </Step>
</Steps>

## Related articles

* [Ceridian Dayforce](/en/integrations/smart-fields/ceridian-dayforce-smart-fields): sync Ceridian Dayforce data into your signatures.
* [ChartHop](/en/integrations/smart-fields/charthop-smart-fields): sync ChartHop data into your signatures.
* [Assign teammates to a signature](/en/assign-teammates-to-a-signature): use Smart Field conditions to assign signatures automatically.
