Skip to main content

Sync SIS Rosters with MingaSync

How do I set up automatic rostering for my school?

This guide will walk you through requesting integration setup, configuring sync settings, syncing class rosters as user lists, managing user list visibility, and setting email notifications for sync results. By the end, you’ll be able to keep Minga aligned with your SIS with minimal manual upkeep.

Permission Level required: Owner | District Manager

In this article:

How to connect your SIS to MingaSync

You can set up MingaSync by contacting Minga Support with district and SIS details, enabling SIS sharing permissions, and submitting the connection request so Minga can configure the integration and run an initial manual sync.

Step-by-step guide to setting up MingaSync

  1. Email Minga Support at support@minga.io with the required setup details
    ○ The name of your district and school you are rostering.
    ○ The name of your School Information System (SIS).
    ○ The name and email address of the district contact responsible for SIS integrations.
    ​

  2. Enable your SIS for sharing with Minga
    ○ Turn on the required SIS sharing permissions so MingaSync can access the rostering data.
    ○ Use the article Enable permissions in your SIS for MingaSync for SIS-specific steps.

  3. Complete and return the Connection Request.
    ○ Fill out the Connection Request sent by the support team.
    ○ Confirm that the Connection Request has been completed by notifying Minga Support at support@minga.io.
    ​

  4. Receive connection confirmation from Minga Support.
    ○ After setup, Minga integration specialists run a manual sync to populate students, teachers, and class rosters.

    ○ Once a successful sync has been completed, the Minga Support team will let you know your MingaSync setup is complete.

Important: MingaSync requires SIS sharing permissions to be enabled, and class roster syncing requires terms to be configured in Minga to create class lists.

How to Configure Your Sync Settings in Minga

You can configure your rostering settings by navigating to People → Rostering, locating Rostering Settings, and turning on the toggles for the user types you want MingaSync to sync.

Step-by-step Guide to Configuring Rostering Sync Settings

  1. Navigate to People.
    ○ Open the Minga admin interface and click People.
    ​

  2. Open Rostering.
    ○ Click Rostering to access syncing controls.
    ​

  3. Locate Rostering Settings.
    ○ Scroll until you see the Rostering Settings section.
    ​

  4. Turn on the rostering toggles you want.
    ○ Turn on Student rostering, Teacher rostering, Staff rostering, and Admin rostering as needed.
    ○ Turn on Include Primary Parent Contact Info if you want parent contact data included in the sync.

Important: Keep Auto update and Archive turned off until you confirm your rostering sync is working correctly, then turn them on when you are ready for automated updates and archiving.

Sync Class Rosters into User Lists

You can automatically pull in your class rosters from your SIS and have them populate as User Lists in Minga. To do this, sharing permissions by schools or sections needs to be enabled, as well as sharing term data, during the integration.

Step-by-step guide to Configuring Class Lists

  1. Turn on Sync class rosters as user lists automatically.
    ○ This enables Minga to create and update class lists based on SIS class rosters.
    ​

  2. Click Manage next to Manage class rosters to be synced.
    ○ This will show what terms are currently being brought in from your SIS.

    ○ If you do not see the correct terms, double-check that they are being shared with Minga in your SIS.
    ​
    ​

  3. Select the Terms you would like to bring in classes for.
    ○ Class lists will not roster in unless terms are selected.
    ​

  4. There is also an option to select which Grades you would like to bring in lists for.
    ○ It is best practice to leave ALL grades UNSELECTED as this can prevent all user lists from importing.
    ​

  5. Click Save, then click Save again
    ○ Save the roster selection and save the overall configuration.

There is also an option to automatically create auto-generated lists by role, grade, subject, and teacher. This allows MingaSync to create and update user lists during overnight syncs.

Step-by-step Guide to Customizing Roster-Generated User Lists

  1. Navigate to People.
    ○ Open the admin interface and click People.
    ​

  2. Click Settings.
    ○ The Settings page includes user list generation controls.
    ​

  3. Turn on the auto-generated list options you want
    ○ Turn on any of the following settings:
    ○ Make new user lists public by default
    ○ Enable auto-generated lists by role
    ○ Enable auto-generated lists by grade
    ○ Enable auto-generated lists by subject
    ○ Enable auto-generated lists by teacher
    ​

  4. Confirm the settings remain enabled.
    ○ Enabled settings will cause Minga to create and update those user lists during overnight syncs when SIS data changes.

Note: These settings are toggled OFF by default, but can be toggled ON by an Owner or District Manager.

Rostered User Lists import as private by default, which limits access to the List Manager (generally the teacher and co-teachers), Owners, and Managers. However, you can make rostered user lists public or private by selecting lists in People → User Lists and applying Set as private or Set as public.

Step-by-step Guide to Changing User List Visibility

  1. Navigate to People.
    ○ Open the admin interface and click People.
    ​

  2. Click the User Lists tab.
    ○ A list of rostered and manually created user lists appears.
    ​

  3. Select the user lists you want to update.
    ○ Select multiple lists when you want to update visibility in bulk.
    ​

  4. Choose Set as private or Set as public.
    ○ Set as private restricts visibility to list managers and administrative roles.
    ○ Set as public allows all staff to view and use the user lists, including in MyClass.

Tip: Use Set as public for lists that need to be accessible to all staff for daily workflows like MyClass.

Auto Update and Archive Settings

Auto update controls whether MingaSync updates Students/Teachers/Staff if any information in the SIS changes, and Archive controls whether MingaSync removes users who are no longer present in SIS rostering data.

Setting

What it does

Why it helps

Auto update

Updates any information for Students/Teachers/ Staff that has been updated or changed in the SIS.

Ensures that user information, such as name, grade, and class enrolments, reflects the same data as in the SIS.

Archive

Archives users who are no longer listed in SIS rostering data.

Archiving ensures that the correct users have access to Minga, as well as keeping the student count consistent with your subscription.

How to get notified about your daily sync in Minga

Owners and District Managers can enter their email address (or the email address of their IT team) to receive a daily email with a summary report from the nightly roster sync.

Step-by-step guide to Receiving Roster Sync Result Notifications

  1. Navigate to People>Rostering and scroll until the setting Send rostering results email
    ○ Send rostering results email is located just under the class roster configuration settings.
    ​

  2. Toggle the ON the setting and enter the email addresses for those who want a daily report of the sync.
    ○ Enter the email address(es) that should receive the daily sync summary.
    ​

  3. Click Save.
    ○ Saving enables email notifications for roster sync results.

Troubleshooting

Issue: Students and staff are not updating overnight.
​Solution: Confirm that the setting Enable Automatic Rostering is toggled on and there are no errors in the OneRoster History report (located at the bottom of the Rostering page).
○ Double-check that all sharing permissions have been enabled in your SIS.
○ Ensure that the setting Auto Update under the Roster Students and Roster Teachers settings are toggled ON.
​

Issue: Class lists are not appearing in User Lists
​Solution: Double-check that the correct terms are selected under Sync class rosters as user lists automatically. If a new semester has just started, ensure that the new term is selected and you select Save after making any changes.
​

Issue: Manually added users do not update during sync.
​Solution: Check that the user's profile is included in the nightly sync. To check, navigate to People and select the blue edit pencil to view. Scroll until you see the setting Include user in SIS sync and ensure it is toggled ON.
○ It is important to note that manually created users are automatically excluded from the SIS sync. This is to ensure that users who are not listed in their school's SIS are not automatically archived in the nightly sync.
​

Issue: Users who left the school remain active in Minga
​Solution: Confirm that the Archive setting under Roster Students/ Roster Teachers/ Roster Staff is toggled ON.
​

Issue: Teachers cannot find a rostered class list in MyClass
​Solution: You can make the class list available to all staff by selecting the list in People → User Lists and choosing Set as public.
○ Confirm that the setting Include user in SIS sync is toggled ON for the teacher's profile. If it is toggled OFF Minga will ignore this user and will not be able to match their lists to them in Minga.

FAQs

How often does MingaSync update rostering information?

MingaSync updates rostering information every night using automatic overnight syncs, which keeps student, teacher, and class roster information current.

Can MingaSync update users who were manually added in Minga?

Yes, MingaSync can update manually added users if the setting Include user in SIS sync is enabled on their profile and the setting Auto Update is toggled ON for their role in the overall rostering settings.

Can MingaSync remove users who are no longer enrolled or employed?

Yes, MingaSync will archive users who are no longer in the SIS rostering data when Archive is turned on, which supports removing students who leave the school.

Do class rosters sync automatically without term selection?

No, class rosters do not sync automatically without term selection because class lists will not roster in unless Terms are configured.

Related Articles
Manually Add Users to Minga
Enable SIS Permissions for MingaSync
Set Up Rostering through SFTP with MingaSync
Delete and Archive Users from Minga
Did this answer your question?