Skip to main content

Connecting Microsoft Teams Admin Consent

Learn how to connect Microsoft Teams Admin Consent for syncing classrooms with Mindjoy.

Ethan Marrs avatar
Written by Ethan Marrs
Updated over a week ago

Connecting Microsoft Teams Admin Consent

The Microsoft Teams Admin Consent integration allows your organization to sync classrooms across your entire Microsoft 365 tenant. Once connected, educators in your organization can easily import their Teams classes into Mindjoy.

Prerequisites

  • You must be an Organization Admin in Mindjoy

  • You must be a Microsoft 365 Admin (or have permission to grant admin consent for your tenant)

Step 1: Navigate to Organization Integrations

From your Mindjoy dashboard, go to Organization SettingsIntegrations. You'll see the available integrations for your organization.

Find Microsoft Teams Admin Consent and click Connect.

Document image

Step 2: Sign in to Microsoft

You'll be redirected to Microsoft's sign-in page. Select the Microsoft 365 admin account you want to use to authorize the connection.

Document image

Step 3: Grant Admin Consent

Microsoft will ask you to grant Mindjoy permission to access your organization's Teams for Education data. Review the permissions and click Accept to authorize.

This grants Mindjoy read-only access to your organization's class rosters — we never modify any data in your Microsoft 365 tenant.

Document image

Required Permissions for Microsoft Teams Admin Consent

When you connect Microsoft Teams to Mindjoy at the organization level, you'll be asked to grant the following permissions:

Read education roster data (EduRoster.Read.All)

This allows Mindjoy to see which classes exist in your organization and who's enrolled in each class. We use this to sync your class rosters so educators don't have to manually add students.

What we can see:

  • Class names

  • Student names and school email addresses

What we cannot do:

  • Modify classes or rosters

  • Access grades, assignments, or class content

  • Access any data outside of class rosters

Read hidden group members (Member.Read.Hidden)

Microsoft Teams automatically hides class membership for student privacy—only teachers and students within a class can normally see who else is in it. This permission allows Mindjoy to read class rosters even when this privacy setting is enabled.

Without this permission, we'd receive "access denied" errors when trying to sync most school classes.

Why does Mindjoy need these permissions?

Unlike the personal Microsoft Teams connection (where each educator connects their own account), the Admin Consent option lets you connect once for your entire organization. This means Mindjoy needs permission to access all classes—not just one educator's—so any teacher can sync their roster without connecting their personal account.

Step 4: Wait for Setup

After granting consent, you'll be redirected back to Mindjoy. A brief loading screen will appear while we finish configuring the connection.

Document image

Step 5: Connection Complete

Once setup is complete, you'll see a success message. The integration will now show as Connected on your Organization Integrations page.

Document image

Using the Integration

With the integration connected, educators in your organization can now sync their Microsoft Teams classes when creating or editing classrooms.

Importing Students

When creating or editing a classroom, educators can select Import from Microsoft Teams as their sync source. They'll see a list of all available Teams classes from your organization.

Document image

Syncing a Classroom

Select the Teams class you want to sync, and Mindjoy will automatically import the student roster.

Document image

Student rosters stay in sync — any changes made in Microsoft Teams will be reflected in Mindjoy the next time the classroom syncs.

Troubleshooting

I don't see the Connect button Make sure you're an Organization Admin in Mindjoy. Only admins can connect organization-wide integrations.

Microsoft says I don't have permission You need Microsoft 365 admin privileges to grant consent on behalf of your organization. Contact your IT administrator if you don't have the required permissions.

The connection failed after granting consent Microsoft can take a few moments to propagate permissions. Wait a minute and try connecting again.

Disconnecting the Integration

If you need to disconnect the integration, go to Organization SettingsIntegrations, click on the Microsoft Teams Admin Consent integration, and select Disconnect. This will remove Mindjoy's access to your Microsoft 365 tenant. This will also prevent further syncing between Mindjoy and your Microsoft tenant.

Document image

Did this answer your question?