How to integrate TalentLMS with BambooHR

TalentLMS offers an integration with BambooHR software.

This will let you add all your employees from BambooHR into your TalentLMS+ portal easily.

It will also enable you and other BambooHR Administrators to see their employees completed training in BambooHR.

To integrate TalentLMS+ with BambooHR:

Step 1: Connect your BambooHR account.

Log in as an Administrator.
Go to Account & Settings.
Click the Integrations (1) tab

Click on the BambooHR (2) tile.

In the drawer that opens, turn on the Enabled switch.
Enter the subdomain of your BambooHR account (3) and click Update (4).

Note: For this connection to work, you need access via a secure connection. Please make sure you are accessing via https:// and not http://

After clicking Update, a button labeled Connect (1) will appear under the domain input box. Click this and you will be redirected to BambooHR to enter your credentials. Once you’ve entered your credentials and clicked Log in, the connection is complete.

Note: ensure that you click Save at the bottom of the page after selecting this option to save your selection, before clicking Sync.

Step 2: Sync users and courses.

You’ll now have the option to click Sync (6) to add all BambooHR employees to TalentLMS as users, and all of the courses in your TalentLMS portal to the Training section in your BambooHR settings page.

Optional settings

Add new users as inactive (7)

If this option is unchecked, all users from BambooHR with an Active status, Work or Home email, and a hire date in the past, will be added to TalentLMS as active. Furthermore, inactive users in TalentLMS that match an eligible BambooHR user (based on Work or Home email) will be activated and synced.
If this option is checked, the integration will add your BambooHR users as inactive in TalentLMS and prevent inactive users in TalentLMS from being activated by the BambooHR sync. You can manually activate or deactivate users in TalentLMS with this option enabled.

Sync only users with work email (8)

When this option is activated, only users with a valid Work email in BambooHR will be synced to TalentLMS. Users with only a Home email will not be synced.

Import users’ picture from BambooHR to TalentLMS (9)

With this option enabled the BambooHR profile picture will be populated into the TalentLMS user profile.

Auto-assign users to branches based on the selected BambooHR employee field (10)

When enabled, this option automatically assigns users to a TalentLMS branch based on the value of the selected BambooHR field (Department, Division, Location, Country, Job Title, or City). Please ensure that the corresponding branches already exist in TalentLMS and that their names match the values sent from BambooHR.

Note: Branch names do not need to match capitalization, spaces, hyphens (-), or underscores (_) exactly. For example, Product Marketing, product-marketing, and product_marketing are all treated as the same value and will match the same branch, “productmarketing”.

However, other special characters are not ignored, so values such as product & marketing or product marketing will not match. Additionally, values exceeding 50 characters are not supported.

You can choose how existing users are handled:

Keep them where they are and add them to the matching branch, allowing users to remain in their current branches while also being added to the matching one.
Move them to matching branches, transferring users from their current branches to the matching one based on their BambooHR field value.

For users who do not match an existing branch:

Sync users who can't be mapped to a specific TalentLMS branch to the main portal. This applies to users whose BambooHR field values do not correspond to an existing TalentLMS branch.

Make sure to click Save (11) after changing any of the options above.

After syncing, you’ll receive an email verification showing the number of users added or updated in TalentLMS, the number of categories and courses synced to BambooHR, and any branch assignment updates.

Group 5527.png When BambooHR users are created in TalentLMS, a random password is assigned to each one. In order to inform them of the account creation:

Make sure that the "User addition (from an admin)" notification is enabled. If not, create a notification on the "on user create" event, with "related user" as recipient, adding the "related user login" and "related user password" in the body.
Enable the option enforce password change on first login for extra security.

Note: If a default group is set up in TalentLMS, the users will be added to this group and enrolled in the group’s courses. If a course shares the same name as another one, only one of these will be pulled through to BambooHR. Please ensure you have unique course names to avoid courses not populating the Training page in BambooHR. If a user exists in TalentLMS already, their account will not be duplicated provided the email address in BambooHR matches the one in TalentLMS, the account will be matched. If the email of the user does not exist in the TalentLMS portal, a new user account will be created.

Courses, course-progress and course categories from TalentLMS will be synced into BambooHR and BambooHR users will be synced into TalentLMS. The system will periodically be syncing with BambooHR but only the first sync is retrieving course completions from BambooHR into TalentLMS.

TalentLMS Courses and Categories are synced with BambooHR's Trainings. The correlation between TalentLMS and BambooHR is based on the name of the Course or Category and the name of the Training in BambooHR and they need to be an exact match. This is case sensitive. Editing the name of Trainings in BambooHR, even capitalization, can cause issues with synchronization. It’s highly recommended that you don’t make any edits to Training names after integrating TalentLMS with BambooHR.

Note: During the TalentLMS - BambooHR integration (the initial sync), if there are any completed Trainings in BambooHR that correspond to Courses in TalentLMS (the name must be an exact match), these courses will be automatically assigned and marked as completed in TalentLMS.

In regards to the user information sync, on BambooHR, users can have the below attributes:

- jobTitle (text)
- employeeNumber (text)
- hireDate (date)
- department (text)
- division (text)
- location (text)
- country (text)
- city (text)
- state (text)
- supervisor (text)
- dateOfBirth (date)
- ssn (text)
- sin (text)

If you've created the respective custom user fields in TalentLMS with the same name and type, then, the fields on TalentLMS for each BambooHR user will be filled-in/updated with the data from BambooHR.

Step 3: Access TalentLMS courses via BambooHR.

Once you have synced users, your BambooHR Employees will be created as users in TalentLMS, and your active courses will be added to the Training section in your BambooHR portal.

Note: If the user limit is reached with the new users being added via BambooHR, the extra users will be added to TalentLMS, with an inactive status. You can deactivate other user accounts in order to free up space.

Log in to your BambooHR account.
Click the Settings button (1) and then select Training (2). Here you can see the courses and categories (3) that have been pulled from TalentLMS. This option is usually only available for BambooHR administrator roles.

Clicking on an individual course will give you its details, such as Title, Description, and Catalog, as well as the URL to the course in the Course catalog.

Note: If the course is hidden from the catalog, the URL will lead to the course itself, so a login will be required to access the link, and the user will have to be enrolled in the course.

You can also click on an individual employee’s account to see their completed courses, which will be synced with the data in TalentLMS.

Syncing new data

Once you've connected and starting from the moment you did the first sync, with the system will periodically sync with BambooHR on a daily basis.

You may also want to manually sync with BambooHR to pull through new data, such as new courses or course completion data. Or, you might want to add new BambooHR users to TalentLMS.

To do this: