How to upload data to the MGI using OneRoster API

Students must be integrated into the MGI before they can be added to a test plan. The quickest and most secure method to integrate students is to upload data from your district’s School Information System.

Please note that while most students will be integrated through this data upload, you might occasionally need to add a student on an individual basis.

Overview

The MGI supports two methods for data upload:

1. OneRoster API – Automated data sync from supported Student Information Systems (SIS).
2. OneRoster CSV – Manual upload via web interface or SFTP integration.

The One Roster API method of upload is described below. For help with the One Roster CSV method, please consult the One Roster CSV help topic.

Using One Roster API (ClassLink, Infinite Campus, Skyward SMS 2.0, Synergy)

This process is ideal for IT administrators seeking data syncing from their SIS.

Steps to Set Up One Roster API Integration

1. Confirm SIS Compatibility
   • Ensure your district uses ClassLink, Infinite Campus, Skyward SMS 2.0, or Synergy.
   • Verify that One Roster API is enabled in your SIS.
2. Request API Credentials
   • Contact your SIS provider or district IT team for API credentials (Client ID, Client Secret, Endpoint, and other possible parameters).
3. Log into the MGI Application
   • Navigate to Import Data > One Roster API.

   

4. Enter API Credentials
   • Input your SIS API credentials and verify the connection by selecting Test Connection.
5. Test and Activate Sync
   • Run a test sync to check data integrity.
   • If there aren’t any issues with your upload, select the Approve option to complete the merge of your data into the MGI.
   • NOTE: Consider activating automatic syncing for continuous updates.