TalentHR features native TalentLMS integration. Synchronize data between the two platforms and keep track of your employees’ TalentLMS training on your TalentHR domain.
To integrate TalentLMS with TalentHR:
A. Enable the API on TalentLMS
1. Log in to your TalentLMS account as an Administrator and navigate to Account & Settings (1) from the left-hand menu.
2. Select the Integrations (2) tab.
3. Under the Featured section, click on the API (3) option.
4. In the drawer that opens, toggle the API to Enabled (4).
5. Your unique API key will appear. Copy the API key (5) to your clipboard.
6. Click Save (6) at the bottom of the page.
B. Enable the TalentLMS integration on TalentHR to sync users and courses
1. Log in to your TalentHR portal as an Admin or an HR Manager and navigate to Settings (1).
2. Select Integrations (2).
3. Click on the TalentLMS (3) option.
4. Enter the URL (4) of your TalentLMS training portal e.g. yourtrainingportal.talentlms.com.
5. Paste the API key (5) you copied from your TalentLMS portal.
6. Choose a specific TalentLMS branch (6) to sync with, or select All to sync your entire TalentLMS domain with TalentHR.
7. Choose the Direction (7) you need for your integration. TalentHR offers three different directions of integration with TalentLMS: Two Way, From HR to LMS, From LMS to HR.
8. Enable Automatic sync (8) if you want the integration to synchronize data automatically between your TalentLMS portal and TalentHR domain.
9. Click Save (9).
10. Confirm (10) the integration.
If everything has been configured properly, then your TalentHR domain will be integrated with your TalentLMS portal.
Here’s what you need to know about the TalentHR - TalentLMS integration:
1. Which employee/user information is synchronized between the two systems?
When you sync a user from TalentLMS to TalentHR and/or vice versa, these fields will be transferred by default:
- First name
- Last name
- Language.
Additionally, on TalentHR, users can have the following attributes (types):
- hireDate (date)
- dateOfBirth (date)
- ssn (text)
- city (text)
- country (text)
- jobTitle (text)
- department (text)
- location (text)
- division (text)
If you've created the respective custom user fields on TalentLMS with the same names and types, then the fields on TalentLMS will be filled-in/updated for each TalentHR employee with the data from TalentHR (or vice-versa, according to the direction of integration you have selected).
Note: The names of all these attributes are case sensitive. |
2. About the direction of the integration
Depending on the direction you have selected, the outcome will be different. The options are:
- From LMS to HR
The system will sync all active users from TalentLMS, along with their training and progress data, as well as any relevant custom user fields.
If the TalentLMS user does not exist on TalentHR as an employee, their employee profile will be created with their respective required records.
If the employee already exists on TalentHR (based on their TalentLMS ID and email address), their available fields (First name, Last name, Email, Language) will be updated according to their user data on TalentLMS.
Automatic sync does not add any more functionality.
- From HR to LMS
The system will sync all active (non-deleted and non-terminated), as well as inactive (deleted and/or terminated) employees from TalentHR (along with any relevant custom user fields and training progress).
If an active employee does not yet exist on TalentLMS (based on their email address), a new user profile will be created on TalentLMS for the employee.
If an active employee already exists on TalentLMS as a user, their available fields (First name, Last name, Email, Language) will be updated according to their data on TalentHR.
If an inactive TalentHR employee already exists on TalentLMS as a user, their user profile on TalentLMS will be made inactive as well.
If an inactive TalentHR employee does not exist on TalentLMS, the system will ignore them and their data will not be transferred over.
In addition to the above, when Automatic sync is enabled:
- Hiring an employee on TalentHR, automatically adds the new employee to TalentLMS as a user (following the same rules as mentioned above).
- Terminating or deleting an employee on TalentHR, changes the corresponding user’s active status on TalentLMS from active to inactive.
- Updating any available field of an employee on TalentHR will update the respective user fields of the corresponding user on TalentLMS.
- Two Way
Two-way integration functions as a combination of From LMS to HR and From HR to LMS, but with one caveat. The system will not update employees' user fields on TalentHR based on any updates made to the corresponding users on TalentLMS.
Only new employees will be created on TalentHR, corresponding to any TalentLMS users that do not yet exist on TalentHR.
The system will update users on TalentLMS based on updates to the corresponding employees on TalentHR normally. Also, course enrollments and course progress will be synced between domains.
3. About the Hire date field
Every TalentHR employee needs to have a hire date defined for their profile. When adding a TalentLMS user to TalentHR, if no hireDate custom user field exists on TalentLMS, or if the field exists but it is empty or invalid, the system will use the date of creation of the employee’s TalentLMS user account as their hire date on TalentHR.
4. About the Automatic and Manual sync options
- If Automatic sync is enabled, user updates made on TalentLMS e.g. new users, course enrollments etc. will be synchronized with TalentHR 12 hours after the initial activation of the integration, and every 24 hours afterwards.
On the other hand, any employee updates made on TalentHR will be instantly synced with TalentLMS.
For every automatic sync that is triggered, an email is sent to the company administrator/owner of the TalentHR domain.
- If Automatic sync is disabled, no synchronization will take place after the initial manual sync. The initial sync occurs upon first activating the integration and you will need to sync any new changes manually, using the Manual sync button.
Depending on the direction of your integration, as well as how you prefer to handle data sync at any point, you may want to manually sync with TalentLMS to pull up new data, such as new employees, courses, or course completion data, or to add new TalentHR employees to TalentLMS.
To perform a manual sync:
1. Log in to TalentHR as an Admin or an HR Manager and navigate to Settings (1).
2. Select Integrations (2).
3. Click on TalentLMS (3).
4. Click Manual sync (4).
Once your integration with TalentLMS has been completed, you will be able to review and manage your employees' TalentLMS training directly from your TalentHR domain.
Read this article for more information.