Manager Assignment via Integrations

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

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

  1. Navigate to Settings in the sidebar

  2. Select Integrations (or Company Settings → Integrations)

  3. Find your HR integration (e.g., HiBob, BambooHR)

  4. Access integration settings

  5. Locate "Manager Sync" or similar setting

  6. Enable manager synchronisation

  7. Map the manager field from your HR system

  8. Save and test the configuration

Verifying Manager Sync

After enabling:

  1. Trigger a sync (or wait for scheduled sync)

  2. Check user profiles to verify manager assignments

  3. Compare with HR system to ensure accuracy

  4. Review sync logs for any errors


Integration-Specific Configuration

HiBob Integration

Manager field: Typically reports_to or similar

Configuration steps:

  1. Enable HiBob integration in Learn Amp

  2. Configure API credentials

  3. In field mapping, map the "Manager" field to HiBob's manager field

  4. 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:

  1. Enable BambooHR integration

  2. Configure API key

  3. Map manager field in attribute mapping

  4. 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:

  1. Set up SCIM provisioning from Okta

  2. Ensure manager attribute is included in push

  3. Configure attribute mapping in Learn Amp

  4. 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:

  1. Set up SCIM provisioning from Microsoft Entra ID

  2. Include manager in provisioned attributes

  3. Map attributes in Learn Amp SCIM settings

  4. 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:

  1. Email address (most common)

  2. Employee ID (if configured)

  3. External ID (from HR system)

Example flow:

  1. HR system shows "Jane reports to Tom"

  2. Integration sends Tom's identifier (email/ID)

  3. Learn Amp finds Tom's user record

  4. Jane's Override Manager is set to Tom

Sync Timing

Integration Type

Sync Frequency

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:

  1. Update reporting lines in your HR system first

  2. Allow integration to sync changes to Learn Amp

  3. Verify new relationships after sync completes


Troubleshooting Integration Issues

Common Problems

Issue

Likely Cause

Solution

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

  1. Navigate to Integration settings

  2. View sync logs or history

  3. Look for errors related to manager assignment

  4. 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

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