1. Minga Support
  2. Automatic Rostering

Setting Up OneRoster for Skyward

Set up Minga in Skyward prior to inputting API details into Minga People

Permission Level: Owner | District Manager

 

Typically a representative from your IT Department at your site or district can access Skyward and provide the required information as seen in the steps below to connect to your SIS.

Step 1: Set Up Minga as a Secured User

  1. Navigate to Product Setup > Skyward Contact Access > Security > Secured User.

  2. Click Add

  3. Select the Organization button

  4. Enter "Minga" then click Add Entered Name to Secured Users.

  5. Enter Address information (optional) and Save.

  6. Enter Contact name, phone, and/or email (optional) and Continue Add.

  7. Enter Security Info and Save.

    • Note: Minga must be an Active Secured User but does not need any other permissions and the password will not be used.

Minga

Step 2: Generate an API Key and Secret

  1. Highlight Otus in the Secured User list and click the API button in the lower right corner of the screen.

  2. Click Generate a New Secret.

  3. Copy and paste the Key and Secret into a document. (Do not take a screenshot)

Body

Step 3: Locate the API URL to Share

  1. Navigate to Product Setup > Skyward Contact Access > District Setup > Configuration > API Configuration.

  2. Copy the OneRoster API URL and add it to the document with the Key and Secret.

Untitled design-4

Step 5: Input Details into Minga

  1. Log into app.minga.io 

  2. Go to People > Rostering

  3. Select OneRoster API and Other from the drop down menus and enable automatic rostering

  4. Input required fields:

    • URL: This is the OneRoster API URL for your Skyward application. 

    • API Key

    • Client Secret 

    • School ID: This is the School ID to ensure Minga requests the appropriate roster in the event that multiple schools share the same SIS. 

  5. Once you've completed the form click Save and Test Connection / URL to ensure Minga is able to connect to your SIS and exchange information. 


    Screenshot 2024-06-10 at 4.50.55 PM

Step 6: Configure Sync Settings in Minga 

Sync Settings in Minga

You can enable student, teacher, staff and admin rostering separately as well as include Primary Parent Contact Info depending on what data you want to synchronize in Minga. 

Screenshot 2023-12-21 at 12.00.29 PM

Minga can automatically update information for existing users (for example if a student's name was changed in the SIS then their name would be automatically updated in Minga). By default Minga will Skip users that are already setup in Minga. To automatically update their information toggle on Auto update.

Minga can also automatically Archive (delete) users that are no longer included in the rostering data (for example when a student leaves the school) by toggling on Archive.

Please note*: Minga recommends having the Auto update and Archive settings toggled off at first until you have verified your rostering is syncing correctly in your Minga. Then toggle them on accordingly to ensure up-to-date rostering.  

Get notified of Roster Sync Results

Owners can set up an email notification with all of the information from the daily roster sync. This will allow technical owners to get assurance that the sync is working or to troubleshoot immediately if any issues are detected.

Screenshot 2024-06-10 at 2.50.47 PM

Click Save

Screenshot 2024-06-10 at 2.12.55 PM