Introduction
Microsoft Teams integration requires specific Graph API permissions, and some organizations require IT admin approval. This guide explains Teams permission errors and how to resolve them.
Understanding Teams Permissions
Teams integration uses Microsoft Graph API with OAuth 2.0 authentication.
Required permissions (scopes):
- User.Read - Basic user profile access
- OnlineMeetings.Read - Read meeting details from your calendar
- OnlineMeetingRecording.Read.All - Access meeting recordings (requires admin consent)
Admin Consent Required
User Consent vs Admin Consent
There are two types of authorization flows for Teams integration:
Basic permissions (User.Read, OnlineMeetings.Read) that individual users can approve themselves when connecting Teams.
Organization-wide permissions (recording access) that require IT admin approval in Azure AD portal or Microsoft 365 admin center.
Admin Approval Required Error
If you see "Admin approval required" or "Need admin approval," your organization requires IT admin consent.
Steps to resolve:
- Contact your IT department or Microsoft 365 administrator
- Explain that you need NoteWave approved for Teams integration
- Provide the app name: "NoteWave" and required scopes (listed above)
- Admin approves the app in Azure AD Enterprise Applications
- Once approved, try connecting Teams again in NoteWave
For IT Admins
Personal vs Work/School Accounts
NoteWave Teams integration works with both Microsoft account types, but permissions differ.
Available permissions depend on the Microsoft account and service configuration. If consent is refused or unsupported, use Paste Link or contact support.
Managed by organization IT. May require admin approval for recording access and other advanced permissions.
Reconnecting Teams Integration
If your Teams connection stops working or shows "Disconnected," try reconnecting:
Reconnection steps:
- Go to Integrations
- Click "Disconnect" next to your Teams connection
- Wait 5 seconds for disconnection to complete
- Click "Connect Teams" and sign in with your Microsoft account
- Approve all requested permissions (or request admin approval if needed)
NoteWave attempts to keep a valid connection refreshed. Reconnect when access was revoked, an administrator changed consent, or the integration shows a disconnected or warning state.
Delegate Calendar Issues
Meetings on delegated or shared calendars may not sync properly.
Use Primary Calendar
External User Meetings
Meetings organized by external users may have limited API access.
If you're invited to a Teams meeting by someone outside your organization, NoteWave may have limited access to the meeting details or recording.
Workaround: Use Record > Paste Link to send the notetaker with the Teams meeting URL instead of relying on calendar sync.
Calendar Updates Stop Appearing
If newly created or changed Teams events stop appearing, first check the connection and calendar event rather than waiting indefinitely.
What to check:
- Teams still shows Connected in Integrations
- Auto-join all meetings is enabled
- The event is on the connected account's primary calendar
- The event contains the full Teams join URL
If several eligible meetings are missed, reconnect Teams to renew the connection and permissions, then use Paste Link for any imminent meeting.
Temporary Microsoft Service Errors
Microsoft may occasionally return a temporary connection or service error even when your permissions are correct.
Automatic Retry
Still Blocked by Permissions?
If you've contacted your IT admin and still can't connect Teams:
Contact Support
We can provide your IT team with detailed documentation about NoteWave's security model and required permissions to help with approval.
Was this article helpful?
Your feedback helps us improve our documentation.