PeopleHR Integration
- Mollie Aspley
Integration Summary
Our integration with PeopleHR creates a connection between the two platforms that automatically syncs user information stored in PeopleHR to Learn Amp. This eliminates the need to import or regularly maintain user information in Learn Amp.
Main Features
Syncing users is seamless and efficient, eliminating any need for manual work.
All of your company’s employees that are in PeopleHR are automatically synced into Learn Amp.
In the future, when new users are added into your company’s PeopleHR system, they’ll automatically be added into Learn Amp too.
Standard fields such as an employee’s name, job title, manager, and team are also pulled into Learn Amp.
If an employee’s details (such as job title or team) change in PeopleHR, these changes will be automatically reflected in Learn Amp too.
You can choose when to invite users from your PeopleHR system into Learn Amp, so there’s no rush or need to do so immediately.
Information that can be synced
Our ‘Out of the box’ integration with PeopleHR is able to map information from a number of predefined standard mappable fields which have been detailed in the table below:
Field in PeopleHR | Maps to field in Learn Amp |
|---|---|
People HR ID | id |
First Name (or Known As) | first_name |
Last Name | last_name |
Job Role | job_title |
Employee Image | avatar |
Location | primary_location |
Department | primary_team |
Reports To | override_manager |
Start Date | hire_date |
Leaving Date | leave_date |
Company | Used if integration is set up to only import users with a specific "company" on People HR |
Integration Settings
Learn Amp administrators can choose to apply the following settings:
Setting | Description |
|---|---|
Company (optional)
| Only import employees with this specific Company selected in PeopleHR. If left blank, the integration will import all employees, regardless of Company |
Invite new joiners into Learn Amp (single select)
| Choose when to send invitations to new users. |
Primary Team in Learn Amp (single-select)
| Choose how PeopleHR creates Primary Teams in Learn Amp. |
Primary Team in Learn Amp (optional)
| Choose how PeopleHR removes and assigns managers to Primary Teams in Learn Amp. |
Assign Override Managers in Learn Amp (optional)
| Choose how Managers are assigned in Learn Amp. If this setting is not selected, a user’s manager will be set to the manager of their primary team. Primary Team managers can be assigned in Learn Amp. |
Other settings (optional)
| Choose how PeopleHR interacts with Learn Amp. |
Syncing Additional Information
Yes, It is possible to sync additional or different data points from PeopleHR in to Learn Amp.
Please Note: These requests will be handled by your Implementation Coach and will require custom development work to be undertaken by our technical team. The time taken to complete this work is chargeable or can be deducted from your Implementation budget at your Coaches' discretion.
Known Limitations/ Considerations
Team Managers: The PeopleHR integration will sync each individual users' manager into Learn Amp if the data is available to do so ('Reports to' field in PeopleHR). This is what is known as an Override Manager in Learn Amp. The Integration does not have the ability sync Team/Department managers in to Learn Amp.
However, Team managers can be configured within Learn Amp to work in conjunction with Override Managers. Your Implementation Coach can provide further details on this.
Team Hierarchy: PeopleHR can create a team for each of the individual departments that are stored in your PeopleHR account (optional). These will be presented as a flat structure in your Learn Amp account and will not consider any parent/child relationships between your departments.
However, once you have completed your initial sync, you will be able to easily create parent/child relationships with your teams in Learn Amp which will be saved moving forward. Your Implementation Coach can provide further details on this.
How the Platforms Connect
Learn Amp will generate a unique webhook URL that you can use to create a series of subscriptions based on employee update events in PeopleHR. Learn Amp then connects to PeopleHR using an API token which can be generated by an Administrator of your PeopleHR account.
When an event subscription is triggered, PeopleHR will automatically sync any new or updated user information to Learn Amp.
Integration set-up
Integration flow
Learn Amp fetches a user’s information from PeopleHR by looking up the PeopleHR Id for the user. If no matching user is found in Learn Amp, a new user account is created in Learn Amp.
Permissions/Scopes Required
Our integration with PeopleHR relies on two calls to the PeopleHR API in order to fetch user details:
Get All Employee Detail
Get Employee Detail By Id
Required Stakeholders
To set up our Integration with PeopleHR, you will need somebody with administrator level access to your PeopleHR account. This person will also need administrator level access to your Learn Amp Live account for the period of time in which the Integration is being set up.
Set up Instructions
Full instructions on how to set up the PeopleHR integration can be found within your Learn Amp account. Please go to yourdomain.learnamp.com/en/integrations/people_hr
Other Frequently Asked Questions