PeopleHR Integration

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
	full_name
	first_name
	last_name
	email
	job_title
	location
	primary_team
reports to	override_manager
hire date	hire_date

Integration Settings

Learn Amp administrators can choose to apply the following settings:

Setting	Description
Company (optional) Company field descriptor from PeopleHR	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) Immediately when the user is added Delay until their hire date Don’t invite automatically (can send invites manually)	Choose when to send invitations to new users.
Primary Team in Learn Amp (single-select) Use PeopleHR Department Do not add a Team to Learn Amp using PeopleHR Department	Choose how PeopleHR creates Primary Teams in Learn Amp.
Primary Team in Learn Amp (optional) Remove any teams added by this integration that no longer match PeopleHR departments When teams are added by this integration set the team manager as the ‘owner’ role user	Choose how PeopleHR removes and assigns managers to Primary Teams in Learn Amp.
Assign Override Managers in Learn Amp (optional) Use the ‘Reports to’ field in PeopleHR to set the user’s Manager in Learn Amp	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) Use the ‘Known as’ field in PeopleHR to set the user’s first name in Learn Amp Do not email the user if the PeopleHR integration updates their details in Learn Amp Fallback to email when PeopleHR identifier is not found in Learn Amp	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

Integation 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

For our integration with PeopleHR to work effectively, we ask you grant permissions to the following webhook subscriptions:

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

What field does Learn Amp use as the unique identifier to create and update users?

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. If a matching user is found, the user’s profile will be updated in Learn Amp.

What happens when a user's PeopleHR ID is changed?

A new user account will be created with the new PeopleHR ID.

To avoid this, the integration can be configured to look up users by email when no matching PeopleHR ID is found in Learn Amp. When this setting is applied, a user account will be updated in Learn Amp and a duplicate account will not be created.

I have updated a user's information in PeopleHR but the changes have not been reflected in Learn Amp?

Providing you have all of the webhooks event subscriptions enabled as per the integration set up instructions, PeopleHR should send the updated information over to Learn Amp. This may not happen instantly so allow some time for the change to become visible in Learn Amp.

Should the updated Information still not appear in Learn Amp, press the ‘Import all from PeopleHR’ button on the PeopleHR integration page within your Learn Amp account.

Should I update PeopleHR Learn Amp if a users information changes?

You should always create new users or update existing users information in PeopleHR, not In Learn Amp. Newly created or updated user information in PeopleHR will automatically be synced to PeopleHR.

How often does Learn Amp sync with PeopleHR?

Users are synced at least 24 hours, but will be 'immediately'* synced if...

They are invited to PeopleHR and match the criteria above (e.g. hire date = today).
Sync users button is pressed.

Note: Immediate means that the action will be immediately sent to the queue, sometimes at time of peak traffic, there may be minor delays.

Does the PeopleHR Integration sync team managers?

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.

Can PeopleHR sync users into secondary teams?

A user's primary team will be pulled in via the department's field of the PeopleHR integration.

If you want a user to be part of any other team (i.e. a secondary, or tertiary team), then you will need to add users to these teams in Learn Amp.