Skip to main content

ClassLink Integration

Manage1to1 integrates with ClassLink using the OneRoster standard to synchronize buildings, students, and staff automatically.

ClassLink acts as the authoritative rostering source once enabled, allowing Manage1to1 to automatically stay aligned with your district's SIS data without manual imports.

Permission Required

To configure ClassLink integration, you need the Manage Settings permission assigned to your role.

Think of ClassLink as the bridge between your SIS and Manage1to1 - ClassLink pulls roster data from your Student Information System and provides it to Manage1to1 using the OneRoster standard.

What ClassLink integration does:

  • Imports buildings from ClassLink roster server
  • Synchronizes students and staff automatically
  • Eliminates manual CSV imports
  • Keeps Manage1to1 aligned with your SIS daily

Why use ClassLink:

  • Single Sign-On - If district already uses ClassLink for SSO, roster data is already available
  • Standardized - ClassLink supports OneRoster specification natively
  • Certified - Manage1to1 is a certified vendor on ClassLink's Rostering Platform
  • Automated - Daily sync keeps data current without manual exports

Overview​

ClassLink is a third-party platform that provides roster data to downstream systems using the OneRoster specification. Manage1to1 is a certified vendor on ClassLink's Rostering Platform and consumes roster data directly from the ClassLink API.

How it works:

Your SIS → ClassLink → Manage1to1

When this integration is enabled:

  • Buildings are sourced from ClassLink
  • Students and staff are synchronized automatically
  • Manual CSV-based imports are disabled
  • OneRoster becomes the exclusive roster source

Before enabling OneRoster inside Manage1to1, ClassLink must allow Manage1to1 to access roster data.

What you'll do: Add Manage1to1 as an approved application in ClassLink Roster Server.

Where to do this: ClassLink Roster Server administration portal (requires ClassLink administrator access).

What this grants:

  • Permission for Manage1to1 to read roster data
  • Access to buildings, students, and staff via OneRoster API
  • Proper scopes for data synchronization

Important: This step is completed entirely within ClassLink. ClassLink provides official documentation for adding approved applications, which should be followed to ensure proper permissions and scope are granted.

Typical workflow:

  1. Log in to ClassLink Roster Server as administrator
  2. Navigate to application management
  3. Add "Manage1to1" as approved application
  4. Grant roster read permissions
  5. Note any credentials or identifiers provided by ClassLink

Documentation: Refer to ClassLink's official support documentation for detailed instructions on adding approved applications to the Roster Server.

Once access has been granted in ClassLink, the OneRoster provider can be configured in Manage1to1 from the OneRoster Tab within System Automation.

How to configure:

  1. Navigate to Settings > System Automation > OneRoster tab
  2. Click Update OneRoster (or similar)
  3. Select ClassLink as the OneRoster provider
  4. Enter your district's Tenant ID (provided by ClassLink)
  5. Click Test Configuration to verify connectivity
  6. Save configuration once test succeeds

What you'll need:

  • Tenant ID - Your district's unique ClassLink identifier (provided by ClassLink)

Configuration validation: At a high level, this configuration involves:

  • Selecting ClassLink as the OneRoster provider
  • Supplying your district's Tenant ID
  • Verifying connectivity before activation

Test configuration: The test verifies that Manage1to1 can successfully connect to ClassLink's OneRoster API using your Tenant ID and that permissions are correctly configured.

If test fails:

  • Verify Tenant ID is correct (copy/paste to avoid typos)
  • Confirm Manage1to1 was added as approved application in ClassLink
  • Check that permissions were granted correctly in ClassLink Roster Server
  • Contact Manage1to1 Support if issues persist

After the configuration is validated, Manage1to1 will be ready to synchronize buildings and users from ClassLink.

Step 3: Initial Synchronization​

After enabling the ClassLink provider, perform initial synchronization to import buildings and users.

Building Synchronization​

Run building synchronization first to import all buildings from ClassLink.

How to run:

  1. In OneRoster tab, click Sync Buildings
  2. Wait for synchronization to complete
  3. Review results to confirm all buildings imported

What this does:

  • Imports buildings from ClassLink Roster Server
  • Creates new buildings in Manage1to1
  • Establishes foundation for user imports

Important: Building sync must complete successfully before running user sync.

User Synchronization​

After buildings are synchronized, run initial user synchronization to import students and staff.

How to run:

  1. Ensure building sync completed successfully
  2. Click Sync Users in OneRoster tab
  3. Wait for synchronization to complete (may take several minutes)
  4. Review results to confirm students and staff imported

What this does:

  • Imports students from ClassLink
  • Imports staff from ClassLink
  • Associates users with buildings
  • Creates user accounts in Manage1to1

Step 4: Enable Ongoing Automation​

After initial synchronization succeeds, enable automated imports to keep data synchronized daily.

How to enable:

  1. Navigate to Settings > System Automation > Automation Settings tab
  2. Ensure Enable Automatic Student Import is enabled
  3. Ensure Enable Automatic Staff Import is enabled
  4. Verify Default Daily Automation Time is configured
  5. Save settings

What this does:

  • OneRoster sync runs automatically at configured time (e.g., 2:00 AM)
  • Students and staff data updates daily
  • New users are created, existing users are updated
  • Changes in ClassLink appear in Manage1to1 within 24 hours

Ongoing maintenance: Once configured, ClassLink integration runs automatically. No manual intervention needed for daily operations.

Best Practices​

✅ Do:

  • Test configuration before running initial sync
  • Run building sync before user sync
  • Monitor initial sync to confirm success
  • Enable ongoing automation after successful initial sync
  • Review sync logs periodically to catch failures

❌ Don't:

  • Skip building sync and go straight to user sync
  • Disable automation without understanding impact
  • Change Tenant ID without consulting ClassLink administrator
  • Remove Manage1to1 from ClassLink approved applications while integration is active

Common Questions​

Q: Where do I find my ClassLink Tenant ID? Your ClassLink administrator can provide the Tenant ID. It's also visible in ClassLink Roster Server configuration when Manage1to1 is added as an approved application.

Q: What if my ClassLink sync fails? Check that Manage1to1 is still listed as an approved application in ClassLink and that permissions haven't been revoked. Review sync logs for specific error messages. Contact Support if issue persists.

Q: Can I use ClassLink for SSO and roster sync? Yes. Many districts use ClassLink for both single sign-on authentication and roster synchronization.

Q: How often does ClassLink sync with Manage1to1? Daily, at the configured automation time in Automation Settings. You can also trigger manual sync from the OneRoster tab.

Q: What happens if I remove Manage1to1 from ClassLink approved applications? OneRoster sync will fail. Manage1to1 roster data will become stale until access is restored and sync resumes.

Q: Does ClassLink import guardians? Typically no. OneRoster focuses on buildings, students, and staff. Guardian data is usually imported via CSV separately.

Q: Can I switch from ClassLink to another OneRoster provider? Not recommended. Switching providers can cause data alignment issues. Contact Manage1to1 Support before attempting to switch providers.

ClassLink integration provides reliable, automated roster synchronization for districts already using ClassLink for identity management or single sign-on. Proper configuration ensures daily data sync with minimal maintenance required.

Last updated on