Litmos

How does Litmos integrate with BambooHR?

Purpose: To help you understand what you can use Litmos for and how you can integrate it with BambooHR.

Litmos is the world's fastest growing enterprise learning company, supporting more than 4 million users in over 130 countries and over 22 languages. Our mission is to help your organization improve performance and monetize training by attracting learners through advanced technology and content. With Litmos, you can engage learners through native apps for Android and iOS, extend your ecosystem by using prepackaged connectors and REST API's and protect your data through enterprise-grade security. Litmos has been one of the top learning vendors for more than nine years, has a customer satisfaction rate of over 95%, and received more than 20 awards in 2015.

You can learn more about Litmos in BambooHR Marketplace.

How do I enable the Litmos integration?

Log in to Litmos. Select Account and then the Integrations tab. Scroll down and click BambooHR.

Please note that this integration is not available for all Litmos users. If you do not see BambooHR as an option, you may need to upgrade to a new Litmos subscription.

Additionally, it is important to have a Full Admin user set up this integration for the appropriate information to be accessible through the API.

To enable the integration, follow the steps in the pop-up box:

  1. Check the box to Enable BambooHR.
  2. Enter your BambooHR subdomain.*
  3. Enter your BambooHR login information.
  4. Click Save changes.

*The subdomain is the first part of your BambooHR account URL, so if your account URL is https://helpcontent.bamboohr.com, your subdomain is helpcontent.

Litmos does not store your BambooHR login details. It is used to fetch the API key.

Once you have enabled the integration in Litmos, please contact a BambooHR support hero to have the Litmos Access checkbox display on the employee profile in BambooHR. This field allows you to enable BambooHR employees to sync and provision to Litmos. Without it, employees cannot sync or provision into Litmos.

Once the field is enabled, be sure to check the box for the employees you would like to sync to Litmos. Or use BambooHR's power edit tool to check the box for multiple employees at once.

What data syncs between BambooHR and Litmos?

You can find this information in BambooHR Marketplace. To learn more about syncing fields, please click here.

How do I import BambooHR users into Litmos?

Log in to Litmos. Select the People tab and click Import Employees from BambooHR in bulk under Options.

Click Sync BambooHR Employee List to pull the employees who have the Litmos Access field checked in BambooHR.

After syncing the list, you can select employees individually or in bulk for import. Check all employees you would like to import and then click Import BambooHR Employees into Litmos.

Recent import results can be downloaded for these BambooHR user imports under the "Recent Imports" section. This report confirms that the employees made it into Litmos as Learners or that these Learner profiles were updated. This can also be verified by finding the users in the "People" tab of Litmos.

How do I Enable Webhooks in BamboooHR to make the Sync Automatic?

Webhooks is an optional feature in BambooHR that can automatically push updated employee data into Litmos learner profiles for the compatible integration fields. A BambooHR administrator can configure a Litmos Webhook by following the steps below.

In BambooHR, navigate Settings and click Account. Select Webhooks and click + Add Webhook.

What fields do you want to monitor?

Name the webhook to your preference. Select the fields you would like to monitor through the webhook. The screenshot above includes all available fields that can update in Litmos.

What fields do you want to post?

Under the What fields do you want to post? section, browse for the Litmos Access field on the Training tab. This is a required field to post for the webhook to work.

If you would like to post additional fields, select from the Browse Fields section. Litmos supports the fields in the screenshot above.

What format should the data be in?

Select JSON for the data format.

Where should the data post to?

Enter your Litmos API URL in this option with <> as parameters.

Example: https://integration.litmos.com/bamboohr/upsertuser?apikey<Litmos_API_Key>

If you plan to set up webhooks, view the Litmos API key generated by clicking on the Litmos API icon in the Integrations tab. Please ensure the API key you are using in the webhook has permission to all fields and users in the range of the Webhook. (Optional.)

When should the data send?

Specify a schedule of when the webhooks should fire (e.g., only at 12:00 pm or every hour at 5 after the hour). You can also limit how often a webhook will fire by setting a maximum number of requests per interval in seconds.

Once the webhook data sends to Litmos, the user updates will automatically apply to learners in Litmos. There is no need to click in Litmos to apply these updates manually. 

Where do I go for support for this integration?

If you are an existing customer using this integration, please be aware that Litmos supports this integration.

Click here to find contact information.

What's next?

Do you need help making changes to table data on the employee profile?

Do you need help updating data for multiple employees at once?

Do you want to find out more about our current integrations?