Skip to main content
Review the minimum standard delegated scope mapping for every Microsoft Teams action. The mapping covers chats, teams, channels, messages, users, meetings, and attachments.
Actions that handle channel and chat attachments require Files.ReadWrite.All.While sending and reading message text functions without this scope, attachment handling will fail unless Files.ReadWrite.All is granted.

​
Minimal scopes per action

Each Microsoft Teams connection also requests openid, offline_access, and User.Read. These connection scopes apply in addition to the action scopes in the table.
ActionDescriptionMinimum scopes
Find chatFinds a chat.Chat.ReadWrite
Get channel messageGets a channel message and its attachments.ChannelMessage.Read.All
Files.ReadWrite.All
Get channel messagesGets channel messages and their attachments.ChannelMessage.Read.All
Files.ReadWrite.All
Get chat messagesGets chat messages and their attachments.Chat.ReadWrite
Files.ReadWrite.All
Get meeting transcriptGets a meeting transcript.Calendars.ReadWrite
OnlineMeetings.Read
OnlineMeetingTranscript.Read.All
List all channelsLists channels.Channel.ReadBasic.All
List all chatsLists chats.Chat.Read
List all teamsLists teams.Team.ReadBasic.All
List all users in channelLists users in a channel.ChannelMember.Read.All
List all users in chatLists users in a chat.Chat.Read
List online meetingsLists online meetings.Calendars.ReadWrite
Reply to channel messageReplies to a channel message and can include attachments.Channel.ReadBasic.All
ChannelMember.Read.All
ChannelMessage.Send
Files.ReadWrite.All
Resolve channelResolves a channel.Channel.ReadBasic.All
Team.ReadBasic.All
Resolve chatResolves a chat.Chat.Read
Resolve meetingResolves a meeting.Calendars.ReadWrite
Resolve teamResolves a team.Team.ReadBasic.All
Search messagesSearches messages in channels and chats.ChannelMessage.Read.All
Chat.ReadWrite
Search usersSearches users.User.Read.All
Send channel messageSends a channel message and can include attachments.Channel.ReadBasic.All
ChannelMember.Read.All
ChannelMessage.Send
Files.ReadWrite.All
Send chat messageSends a chat message and can include attachments.Chat.ReadWrite
Files.ReadWrite.All

​
Actions affected by Sites.Selected

Teams channel attachments use the team’s SharePoint drive. With Sites.Selected, Microsoft Graph rejects the filesFolder lookup even when the selected site has write access. Chat attachments use personal OneDrive, so Sites.Selected does not apply to them.
The following actions may not work completely when handling channel attachments with selected site permissions:
When the action reads a channel attachment, it resolves the channel folder through the Microsoft Graph /teams/{teamId}/channels/{channelId}/filesFolder endpoint. Sites.Selected doesn’t authorize this lookup, so attachment retrieval can fail even when the selected site grant allows direct file access.
When the action reads channel attachments, it resolves the channel folder through the Microsoft Graph /teams/{teamId}/channels/{channelId}/filesFolder endpoint. Sites.Selected doesn’t authorize this lookup, so attachment retrieval can fail even when the selected site grant allows direct file access.
When the action sends a channel attachment, it resolves the channel folder through the Microsoft Graph /teams/{teamId}/channels/{channelId}/filesFolder endpoint. Sites.Selected rejects this lookup before the file upload or reply request.
When the action sends a channel attachment, it resolves the channel folder through the Microsoft Graph /teams/{teamId}/channels/{channelId}/filesFolder endpoint. Sites.Selected rejects this lookup before the file upload or message request.