Skip to main content
BambooHR - API Key Authentication

Link your BambooHR account using API key authentication

Collin Peterson avatar
Written by Collin Peterson
Updated over 11 months ago

This article is intended for HelloTeam users with ADMIN Access Level


If you currently are using a Custom Access Level within BambooHR, please check out this article on how to enable sufficient access for Basic User Provisioning!

Step 1: Add your BambooHR subdomain to Merge Link.

For example, if you sign in at "acme.bamboohr.com", add acme.

Do not enter the full "acme.bamboohr.com".


Step 2: Find your BambooHR API key in your BambooHR Account

  1. Log in and click on your name in the upper right-hand corner of any page to get to the user context menu. Click on the API Keys link in the dropdown menu.
    โ€‹It is important to be either have "Full Admin" access or in a custom access level for "All Levels".

2. Click Add New Key in the upper left corner.

3. Input a name, and then click Generate Key.

4. Copy the API key that appears, and add be sure to share this with your HelloTeam representative so that they can complete your authentication.

Note on non-Full Admin Access Levels and Merge Impact:

  1. If you have Employee Access Level:

    1. After linking, you will only be able to view details specific to your profile

    2. There will be a null Employee record around your manager

  2. If you have Manager Access Level:

    1. After linking, you will only be able to view details specific to your profile and only your indirect + direct reports.

  3. If you have Custom Access Level:

    1. You should set your Access Level to view "All Employees", otherwise the data synced will be altered and result in null employee records.

    2. You should allow View Access to information you would want to be synced

    3. You should allow Access to view your section as well to ensure your record is also synced to Merge.


To ensure you are viewing the most current information
regarding this specific HRIS, please visit:

Did this answer your question?