Skip to main content

Skyward Qmlativ Integration Guide

How to setup Skyward Qmlativ API

Overview

Edlio connects to Skyward Qmlativ through Skyward's API system. To enable this connection, you will need to create an Integration Access record in Qmlativ and configure the OneRoster settings. This gives Edlio secure, read-only access to sync student, parent, and staff information into your Edlio platform.

What you will need:

  • Administrator access to Skyward Qmlativ

  • About 10-15 minutes

What Edlio syncs from Qmlativ:

  • Students (name, grade, email, student ID, bus routes)

  • Parents/Guardians (name, email, phone)

  • Teachers/Staff (name, email, employee ID)

  • Classrooms and enrollments

  • Attendance (optional)


Step 1: Navigate to the Integration List

  1. Open the Main Menu in Qmlativ.

  2. Select Administrative Access.

  3. Choose the API module.

  4. Select Integration.

You will see a list of available integrations sorted by Vendor Name and Product Name. Locate the Edlio integration in the list.


Step 2: Open the Edlio Integration

  1. Find the Edlio entry in the Integration List.

  2. Click the Open button on that row.

  3. On the Integration Details screen, select the Integration Accesses tab.

  4. Click Add Integration Access.


Step 3: Fill Out the Integration Access Form

Fill in the following fields:

Field

What to Enter

Name

A friendly label, e.g. "Edlio 2025-26" or "Edlio Integration"

Description

Optional. Add notes if helpful for your records.

Integration

Should auto-fill to "Edlio" if you started from the Integration Details screen.

Key

This is the Client Key (username) for the integration. You may use a value of your choosing.

Authentication Type

Select "Any" (recommended by Skyward).

Is Active

Check this box.

Effective Date

Today's date or when you want the integration to start.

Expiration Date

Leave blank unless your district requires an expiration.

Note: The integration is only active when "Is Active" is checked AND the current date is after the Effective Date. If you set an Expiration Date, the integration will stop working after that date.


Step 4: Configure OneRoster

After filling out the main form, a Configuration section will appear below the Expiration Date. This is where you set up the OneRoster connection, which is how Edlio receives student, parent, and staff data.

  1. Find the OneRoster Configuration section.

  2. Click the arrow next to the OneRoster Configuration selector.

  3. Select an existing configuration if one is available, or click Add One Roster Configuration to create a new one.

If Creating a New OneRoster Configuration:

Field

What to Enter

One Roster Vendor

Select "Edlio" if listed, or click "Add One Roster Vendor" and enter "Edlio".

Code

A short identifier, e.g. "edlio"

Description

Optional.

District

Select your district from the list.

Allow Grade Pass Back

Leave unchecked unless directed otherwise by your Edlio representative.

Note on Grade Pass Back: This feature requires additional Skyward licensing (look for "QM OneRoster API with writeback" under Administrative Access > System > System Profile > Products Owned). This is not needed for the standard Edlio integration.


Step 5: Configure Attendance (Optional)

If your district uses Edlio's attendance features, you will also see an Attendance Configuration section.

  1. Click the arrow next to the Attendance Configuration selector.

  2. Select an existing configuration or click Add Attendance Configuration.

  3. Enter a Description (e.g. "Edlio Attendance Access").

  4. Select the Entities (schools/buildings) the integration should have access to.

Tip: It is common practice to select all relevant entities in a single configuration rather than creating separate ones per school.

If your district does not need attendance syncing, you can skip this step.


Step 6: Save and Notify Edlio

  1. Review your settings.

  2. Click Save.

  3. You will see a confirmation that the Integration Access was created successfully.

Once saved, let your Edlio representative know that the Integration Access has been created. Edlio will handle the remaining connection setup on our end -- no further action is needed from you.

  • If you are in the implementation phase, your Edlio implementation team will be in touch.

  • If you are an existing customer, contact Edlio support through the help desk in your Edlio admin dashboard or email [email protected].



Summary

Step

Action

1

Navigate to Administrative Access > API > Integration

2

Open the Edlio integration and go to Integration Accesses

3

Add a new Integration Access with your Key and settings

4

Configure OneRoster (required for student/parent/staff sync)

5

Configure Attendance (optional)

6

Save and notify Edlio


FAQ

Q: Is the OneRoster Configuration required? A: Yes. OneRoster is the primary method Edlio uses to sync student, parent, and staff data from Qmlativ. It must be configured for the integration to work.

Q: Is the Attendance Configuration required? A: No. Attendance is optional and only needed if your district wants to sync attendance data with Edlio.

Q: What if I already have a OneRoster Configuration for another vendor? A: You can reuse an existing OneRoster Configuration if it covers the same district and settings, or create a new one specifically for Edlio. Creating a separate one gives you more control.

Q: What authentication type should I choose? A: Skyward recommends "Any", which gives the most flexibility and avoids needing changes in the future.

Q: Can I set up the integration in our Training environment first? A: Yes. You can create the Integration Access in your Training environment to test before setting it up in your Live environment.

Q: What if I need to revoke access? A: You can deactivate the integration at any time by unchecking "Is Active" on the Integration Access record, or by setting an Expiration Date.

Q: I'm migrating from SFTP to Skyward Qmlativ API. What do I do? A: Follow the steps above to set up the new API integration, then contact Edlio support to coordinate the switch from SFTP to API sync.

Did this answer your question?