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 Settings → Integrations. You'll see the available integrations for your organization.
Find Microsoft Teams Admin Consent and click Connect.
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.
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.
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.
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.
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.
Syncing a Classroom
Select the Teams class you want to sync, and Mindjoy will automatically import the student roster.
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 Settings → Integrations, 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.
