Connecting Vanta & Bamboo HR

  • Updated

BambooHR has a complex permission model, and before creating this integration there are a couple of things you should consider:

First, you'll need to select a user to link BambooHR in Vanta. The connection relies on OAuth, which means the connecting user will need to be signed into BambooHR when adding the connection in Vanta.
You should decide if you'd like to use an existing BambooHR employee, or create a non-employee BambooHR user for the integration.

Vanta needs at minimum View Only permissions to specific details in BambooHR. Due to this, the access component of this setup is important.


You have two options for access level:

  • Using Full Admin access level
  • Creating a Custom access level

If you opt to create a Custom access level, these View Only settings are required:

Personal Tab:

  • Basic Info 
    •  View Only: Status, First Name, Last Name
  • Contact
    •  View Only: Work Email

Job Tab:

  • View Only: Hire Date
  • Employment Status
    • View Only: Date, Employment Status
  • Job Information
    • View Only: Job Title, Department

See About Themselves

  • Should Employees be able to see their own information?
    • Yes, Allow Access
  • Which Access Level should apply?
    • Full Access




For more on how to create a non-employee BambooHR user, or creating a Custom access role, please see our article; BambooHR: Creating a Custom Access Level and Non-Employee User

Integrating with BambooHR

  • From the left-hand navigation panel, select Integrations
  • Select the Available tab, and search for BambooHR 
  • Select Connect

Screenshot 2024-07-11 at 11.31.22 AM.png

  • A pop-up modal will appear; enter your BambooHR subdomain address. This can be copied from the address bar when you are logged in to BambooHR. The text just before is your domain.
    This should look like

Screenshot 2024-01-25 at 9.34.34 am.png

  • Click Connect BambooHR
  • The pop-up modal will prompt to select a date to import people. By setting this date, Vanta will import any users who were active or termed after the date.
    • For example: if you set the date to October 30th, 2020, Vanta would import all users who left the company after October 30th, 2020, as well as any active users. 

  • Once the date has been selected, hit save. It can take a few hours for the information to fully sync.

Screenshot 2024-07-11 at 11.37.34 AM.png


Reconnect BambooHR in Vanta

If the BambooHR user who initially set up the integration leaves your organization (or is about to) you can easily reconnect BambooHR in Vanta. Here's how you can do this:

  • Sign in to your BambooHR account with the user you'd like to reconnect the integration with.
  • Sign in to your Vanta account, and navigate to the Integrations page: 
  • On the Connections page, scroll down to Human Resources/Payroll, select the  (...) menu, and click Reconnect

    Screenshot 2024-07-11 at 11.38.12 AM.png

  • This will open the window where you set your subdomain for Vanta, enter your BambooHR address, which should look like "" and click Connect BambooHR
  • You will then see a popup where you may select a date to import people. By setting this date, Vanta will import any users who were active or termed after the date. You'll want to select the same date you had set before to ensure the same users stay in the account. 
  • Once the date has been selected, hit save.