Skip to main content

ManageBac integration: how to import and create Kognity classes

Set up Kognity's ManageBac integration. This guide covers initial setup, importing classes & students, and troubleshooting tips.

Courtney Librizzi avatar
Written by Courtney Librizzi
Updated over a week ago

Important Note for Existing Users: If you did not use our ManageBac import last year: Please only select your new students and classes for import. This prevents your continuing students and classes from being unintentionally overwritten or duplicated.


Step 1: Obtain Your ManageBac API Token

To begin the integration process, you must first have your ManageBac API token (key). Click here to learn how to get the ManageBac API token.

Step 2: Set Up the Integration in Kognity

  1. Log in to your Kognity account.

  2. Select 'Manage School' in the top right corner of your screen.

  3. Select the 'Integrations' tab.

    Screenshot of Kognity 'Integrations' tab, showing ManageBac integration option.
  4. Copy the API token (key) from ManageBac into the Kognity API space. If you are unfamiliar. Learn how to how to get the ManageBac API token to set up classes in Kognity.

Step 3: Import Classes and People

After entering the API token:

  1. Select 'Import classes and people'.

    Screenshot of the 'Import from ManageBac' section in Kognity, showing a note that imports can be run multiple times without changing ManageBac data, and a prominent 'Import classes and people' button.
  2. Choose the grade levels you want to import, then select 'Next'.

  3. Select the specific classes you wish to import.

    • Ensure the 'Subject in Kognity' is correct, or change it to the appropriate course using the dropdown menu.

  4. Once your selections are completed, select 'Next'.

    • Important Note on Licenses: Only select subjects for which you have active licenses. You may import additional subjects, but they will be locked from use until your subscription is upgraded. Please contact your Account Manager for license inquiries.

Step 4: Review and Complete the Import

  1. On the summary page, review your selections carefully.

    Screenshot of the Kognity ManageBac class selection step. Shows a table with class names and dropdowns to select the correct subject.
  2. When ready, select 'Next'.

    • Important Note: All imported students and teachers will receive a welcome email with login information at this step.

The import is complete! You can now view all imported classes in Kognity.

Troubleshooting Guide

If you encounter any issues during the integration process, refer to the relevant section below.

Troubleshooting: Selecting Classes to Import

  • Missing Subjects: Kognity only pulls in subjects that we offer (e.g., you will not see Music if it's not a Kognity offering).

  • HL/SL Selection: Kognity automatically suggests HL subjects, but you can select the corresponding SL subject from the dropdown menu if needed.

  • Incorrect Subject Auto-Selected: If the wrong subject is automatically selected, simply choose the correct one from the dropdown menu.

  • New Syllabus/Specifications: For courses that have recently changed, make sure to select the subject with the correct year of First Examination as listed in the title.

  • History Courses: Kognity offers three history textbooks for three different topics. Select one for the initial import (e.g., 'Move to Global War'). The others can be added afterwards either by you in 'Manage Classes' or by the history teacher creating classes themselves.

Troubleshooting: General Issues

  • "The system cannot retrieve my classes and I'm getting an error"

    • First Attempt: Try the import process once more, especially if you have a large number of classes.

    • Confirm ManageBac Setup: Double-check that all your class lists are correctly set up in ManageBac with the appropriate year groups.

    • Still Not Working? If the issue persists, please contact our support team, and we will assist you in uploading your lists.

  • "We only use ManageBac for CORE"

    • Unfortunately, this integration will not be suitable for your setup if you only use ManageBac for CORE subjects. Please contact your Kognity Account Manager for alternative support options.

  • "Our classes have changed in ManageBac"

    • You can run the class import as many times as needed to sync changes.

    • Important: When we import to existing classes on Kognity, we will not delete any users who are no longer in the ManageBac class. This is to prevent students from losing their progress if they were removed from ManageBac by mistake.

    • New students and teachers will always be added to existing classes.

    • To remove anyone from a class or from Kognity entirely, please go to 'Manage School' then 'Manage Classes' within Kognity.

Need Further Assistance?

If you require any other help, please reach out to our support team. You can find the chat bubble at the bottom right corner of your screen, or send us an email at support@kognity.com.

Did this answer your question?