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 appear on the employee profile in BambooHR. This field allows you to enable BambooHR employees to be synced and provisioned to Litmos. Without it, employees cannot be synced or provisioned to Litmos.

Once you enable the field, be sure to check the box for the employees you would like to be synced to Litmos, or you can use our 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 and navigate to the Integration section.

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 enabled 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.

You can download recent import results for these BambooHR user imports under the Recent Imports section. This report confirms that the employees made it into Litmos as Learners or that their Learner profiles were updated. You can also verify this by finding the users on the People tab of Litmos.

How do I enable webhooks in BambooHR to make the sync automatic?

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

In BambooHR, navigate to 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 be updated 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 on 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 be sent?

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 is sent 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.