Manager Assignment via Integrations
Overview
Learn Amp integrates with HR Information Systems (HRIS) and identity providers to automatically sync manager assignments. When your organisation uses a central HR system as the source of truth for reporting relationships, these integrations ensure your Learn Amp manager structure stays up to date without manual intervention.
This guide covers how manager assignments work with popular integrations and how to configure them effectively.
Functionality Breakdown
Supported Integration Types
Integration Type | Examples | Manager Sync |
|---|---|---|
HRIS | HiBob, BambooHR | ✅ Full support |
Identity Provider | Okta, Microsoft Entra ID | ✅ With SCIM attributes |
SCIM | Generic SCIM 2.0 | ✅ With manager attribute |
SSO Only | SAML, OAuth | ❌ No manager sync |
What Gets Synced
When manager sync is enabled:
Override Manager relationships are created/updated automatically
Manager changes in the HR system reflect in Learn Amp
New hires are assigned to their manager on creation
Departures may clear manager assignments (configurable)
Pre-requisites
Role Requirements
To configure integrations:
Owner role
Admin role (for some integrations)
Integration Requirements
Each integration has specific requirements:
API credentials from the HR system
Manager field mapping configured correctly
User matching set up (typically by email)
Sync schedule configured
Quick Start Guide
Enabling Manager Sync in an Integration
Navigate to Settings in the sidebar
Select Integrations (or Company Settings → Integrations)
Find your HR integration (e.g., HiBob, BambooHR)
Access integration settings
Locate "Manager Sync" or similar setting
Enable manager synchronisation
Map the manager field from your HR system
Save and test the configuration
Verifying Manager Sync
After enabling:
Trigger a sync (or wait for scheduled sync)
Check user profiles to verify manager assignments
Compare with HR system to ensure accuracy
Review sync logs for any errors
Integration-Specific Configuration
HiBob Integration
Manager field: Typically reports_to or similar
Configuration steps:
Enable HiBob integration in Learn Amp
Configure API credentials
In field mapping, map the "Manager" field to HiBob's manager field
Enable automatic sync
What syncs:
Manager relationships based on HiBob's reporting structure
Changes sync on schedule (configurable frequency)
BambooHR Integration
Manager field: Typically supervisorId or reportsTo
Configuration steps:
Enable BambooHR integration
Configure API key
Map manager field in attribute mapping
Enable scheduled sync
What syncs:
Direct supervisor relationships
Updates when reporting changes occur in BambooHR
Okta Integration (SCIM)
Manager attribute: manager in SCIM schema
Configuration steps:
Set up SCIM provisioning from Okta
Ensure manager attribute is included in push
Configure attribute mapping in Learn Amp
Enable manager sync from SCIM data
What syncs:
Manager assignments pushed from Okta
Real-time updates (SCIM push-based)
💡 Tip: Okta must have manager data populated (often from an upstream HR system) for this to work.
Microsoft Entra ID Integration (SCIM)
Manager attribute: manager in Microsoft Entra ID
Configuration steps:
Set up SCIM provisioning from Microsoft Entra ID
Include manager in provisioned attributes
Map attributes in Learn Amp SCIM settings
Enable manager synchronisation
What syncs:
Manager relationships from Microsoft Entra ID
Updates when Microsoft Entra ID manager field changes
How Manager Sync Works
Matching Logic
The integration matches managers using:
Email address (most common)
Employee ID (if configured)
External ID (from HR system)
Example flow:
HR system shows "Jane reports to Tom"
Integration sends Tom's identifier (email/ID)
Learn Amp finds Tom's user record
Jane's Override Manager is set to Tom
Sync Timing
Integration Type | Sync Frequency |
|---|---|
SCIM (push) | Near real-time |
HRIS API | Scheduled (hourly/daily) |
Manual trigger | On-demand |
Conflict Resolution
When managers are set both manually and via integration:
Integration typically wins on next sync
This ensures HR system remains source of truth
Configure carefully if you need manual overrides
⚠️ Warning: Manual manager changes may be overwritten on the next integration sync. Use your HR system as the source of truth for manager relationships.
Handling Common Scenarios
Manager Not in System Yet
If the designated manager doesn't exist in Learn Amp:
Option 1: Create manager user first (manually or via sync)
Option 2: Configure to skip/queue until manager exists
Option 3: Import fails for that user (check error logs)
Manager Leaving the Organisation
When a manager is deactivated:
Direct reports may need reassignment
Some integrations handle this automatically
Review orphaned users after manager departures
Organisational Restructuring
During restructuring:
Update reporting lines in your HR system first
Allow integration to sync changes to Learn Amp
Verify new relationships after sync completes
Troubleshooting Integration Issues
Common Problems
Issue | Likely Cause | Solution |
|---|---|---|
Managers not syncing | Manager field not mapped | Check field mapping configuration |
Wrong managers assigned | Incorrect field mapping | Verify source field contains correct data |
Some users missing managers | Manager doesn't exist in Learn Amp | Ensure all managers are created first |
Sync errors in logs | API issues or data problems | Review error messages; check HR system data |
Checking Sync Status
Navigate to Integration settings
View sync logs or history
Look for errors related to manager assignment
Check specific user records for issues
Manual vs Automated Management
When to Use Integration Sync
✅ Use integration when:
HR system is your source of truth
Reporting lines change frequently
You have a large organisation
Consistency with HR data is critical
When to Use Manual Assignment
✅ Use manual when:
Learn Amp structure differs from HR system
Integration doesn't support manager sync
You need overrides for specific cases
Temporary arrangements not in HR system
⚠️ Warning: Mixing automated and manual approaches requires careful management. Integration syncs may overwrite manual changes.
FAQs
Does manager sync work with SSO-only setups?
No. SSO (SAML/OAuth) handles authentication only, not attribute provisioning. You need SCIM or direct HRIS integration for manager sync.
What if a user has multiple managers in my HR system?
Learn Amp supports one Override Manager per user. The integration typically uses the primary/direct manager field. Review your HR system's field structure.
Can I prevent integration from overwriting manual changes?
This depends on integration configuration. Some integrations allow "skip if value exists" options. Contact support for specific guidance.
How quickly do manager changes sync?
SCIM-based integrations sync near real-time. API-based HRIS integrations sync on schedule (typically hourly or daily).
What happens if I disconnect the integration?
Existing manager assignments remain in place. They just won't update automatically anymore.
Can I sync Team Managers via integration?
Most integrations sync Override Managers (individual reporting relationships). Team manager assignments are typically managed separately within Learn Amp.
Troubleshooting
Issue | Solution |
|---|---|
Manager sync not working at all | Verify integration is enabled and manager field is mapped |
Incorrect managers being assigned | Check source data in HR system; verify field mapping |
Sync errors for specific users | Manager may not exist in Learn Amp; check user matching |
Changes not appearing after HR update | Wait for next sync cycle; trigger manual sync if available |
Integration showing as disconnected | Re-authenticate integration; check API credentials |
Last Review date: November 2025