Connecting Vanta & Bamboo HR

Katie D.
Katie D.
  • 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
    or
  • 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


bamboohr_others.png

mceclip0.png

 

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-01-25 at 9.28.31 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 .bamboohr.com is your domain.
    This should look like youraccount.bamboohr.com

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.

bamboo_3.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: https://app.vanta.com/integrations 
  • On the Connections page, scroll down to Human Resources/Payroll, select the  (...) menu, and click Reconnect

    Bamboo_2-1.png

  • This will open the window where you set your subdomain for Vanta, enter your BambooHR address, which should look like "youraccount.bamboohr.com" 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.