How does Litmos Integrate with BambooHR?
Purpose: To help you understand what Litmos is used 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's Marketplace.
Login to Litmos. Navigate to "Account" and select the "Integrations" tab. Then scroll down and click on "BambooHR."
Please note that this integration isn't available for all Litmos users. If you do not see BambooHR as an option, then you may need to upgrade to a new Litmos subscription.
Additionally, it is important that a user with Full Admin access sets up this integration so the appropriate information is accessible through the API.
To enable the integration, follow the steps in the pop-up box:
- Check the box to "Enable BambooHR."
- Enter your BambooHR subdomain.*
- Enter your BambooHR login information.
- Click "Save changes."
*The subdomain is the first part of your BambooHR account URL. So if your account URL is: https://helpcontent.bamboohr.com then your subdomain is "helpcontent."
Litmos does not store your BambooHR login details, it will be used to fetch the API Key.
Once the integration is enabled in Litmos, please contact a BambooHR support hero to enable the "Litmos Access" checkbox that will display on the employee profile in BambooHR. This field is used to enable BambooHR employees for syncing and provisioning to Litmos. Without it, employees cannot be synced or provisioned into Litmos.
Once the field is enabled, be sure to check the box for the employees you'd like to sync to Litmos. Or use BambooHR's power edit feature to check the box for multiple employees at one time.
Login to Litmos. Navigate to 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.
Once the employee is listed, they can then be selected individually or in bulk for import. Simply check all employees you'd 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.
Webhooks is an optional feature in BambooHR that can be used to 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 to Settings and click on "Account." Select "Webhooks" and click "+ Add Webhook."
What Fields do you want to Monitor?
Name the webhook to your preference. Then select the fields you'd 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 in order for the Webhook to work.
If you'd like to post additional fields, select from the "Browse Fields" section. Litmos supports the fields in the screenshot above.
Where Should the Data be Posted?
Enter your Litmos API URL in this option with <> as parameters.
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 that the API key being used 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 be automatically applied to Learners in Litmos. There is no need to manually click anywhere in Litmos to apply these updates.