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. If you use an existing employee, keep in mind that you will need to reconnect BambooHR in Vanta in the event that the connecting employee leaves. 

Next, you'll want to make sure the selected user in BambooHR has the appropriate access level. 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


This user will also need to have access to see information about other employees, as well as see info about themselves. 


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


Adding BambooHR in Vanta

Once you've picked a user and ensured they have the necessary access level:

  • Sign in to your BambooHR account with the selected user.
  • Sign in to your Vanta account, and navigate to the Integrations page https://app.vanta.com/connections
  • On the Integrations page, scroll down to Human Resources/Payroll, and select Connect, then BambooHR.
  • Next, click Connect BambooHR and enter your BambooHR address, this should look like
    "youraccount.bamboohr.com" and click Connect BambooHR
  • You will then see a popup where you can 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 connections page: https://app.vanta.com/connections
  • 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. 

 

 

 

 

 

 

 

Was this article helpful?

Have more questions? Submit a request