All Collections
I am an Alleo Administrator
HRIS & Payroll Integrations
BambooHR integration
BambooHR integration
Aleksandra avatar
Written by Aleksandra
Updated over a week ago


By setting up the integration between BambooHR and Alleo you will achieve following:

  • All the existing employees in your BambooHR account will be added to Alleo.

  • Any mutations in BambooHR (on and off-boarding of employees) will automatically be synced with Alleo on a daily basis.

Setting up the integration

The following high level steps need to be completed to set up the integration:

  1. Create a BambooHR login for the Alleo integration

  2. Create an API key

  3. Share the key with Alleo via an encrypted secret sharing service (1password, onetimesecret.com, or similar)

  4. Alleo performs a check and once approved by you the integration is enabled.

Creating a BambooHR API Key for Integration

The following instructions will show you how to create a new API key:

  1. Log in to Bamboo HR as an administrator

  2. In the action menu go to Access Level tab and select “Add a Non-Employee User” (as shown below in the example)

  3. You will then be able to enter the first name, last name, birthday and email address of the user

  4. Once you create the user, you can assign Custom Access Level

  5. When assigning Custom Access Level, please make sure to provide Read only access to at least the following fields:

    1. Personal section:

      1. First Name

      2. Last Name

      3. Work Email

      4. Birthday

    2. Under Job section:

      1. Hire date

      2. Original hire date

      3. The complete Employment Status section (all subitems)

    3. Optional:

      1. Location

      2. Alleo access field (if applicable)

Creating the API Key

Now the non-employee user is created, the next step is to create an API key for the integration.

  1. Log in as the non-employee user, this way the API key will only have the same access as the non-employee user you created.

  2. Navigate to your profile picture in the top-right corner of your account and select "API Keys." (As show as the example below).

  3. Click “Add a New Key”, The access allowed by each API key is based on the Access Level of the user who generated it.

  4. Click "Show" to show the entire API key.

  5. Copy that value into a notepad or text application.

  6. Share this API key via an encrypted secret sharing service (1password, onetimesecret.com, etc) with your Customer Success Representative at Alleo.

Which data is exchanged between BambooHR and Alleo?

The following data will be retrieved per employee:

  • First Name

  • Last Name

  • Business email

  • Private email (if business email is not available)

  • Birthday (if applicable)

  • alleo

Optional: Selective syncing of employees

If not all the employees who are in BambooHR need to get access to Alleo (for example, due to employee location or position) a custom field needs to be added.

In order to set up this custom field you need to contact BambooHR customer support, and request the following:

  • Add a field called “alleo_access”

  • Add the field to the Job tab

  • Make the field type boolean (true / false)

Once the field is added, please make sure to set it to TRUE for all employees who need to get access to Alleo (see example image below).
​

Optional: Assigning varying budgets

If you would like to vary the Alleo budget assigned to employees, this can be achieved by adding custom field(s) in Personio to indicate per employee what the budget is that the employee should receive. Follow the instructions in this article to set this up.

Did this answer your question?