Outlook Email - Docs

Review the validated minimum standard delegated scopes for every Outlook Email action. The mapping covers mailbox, contact, directory, and file access.

Actions that access shared mailboxes require .Shared scopes.You can remove .Shared from some actions that also work with your own mailbox, but those actions then cannot access shared mailboxes. Send reply from shared mailbox requires Mail.ReadWrite.Shared and Mail.Send.Shared.

Minimal scopes per action

Each Outlook Email connection also requests email, offline_access, openid, and User.Read. These connection scopes apply in addition to the action scopes in the table.

Action	Description	Minimum scopes
Add category to email	Adds category to email.	`Mail.ReadWrite` `Mail.ReadWrite.Shared`
Create contact	Creates contact.	`Contacts.ReadWrite`
Create draft	Creates draft.	`Mail.ReadWrite`
Create draft in shared mailbox	Creates draft in shared mailbox.	`Mail.ReadWrite.Shared`
Create folder	Creates folder.	`Mail.ReadWrite`
Create folder in shared mailbox	Creates folder in shared mailbox.	`Mail.ReadWrite.Shared`
Draft reply to message	Draft reply to message.	`Mail.ReadWrite`
Draft reply to message in shared mailbox	Draft reply to message in shared mailbox.	`Mail.ReadWrite.Shared`
Flag email	Flag email.	`Mail.ReadWrite`
Flag email in shared mailbox	Flag email in shared mailbox.	`Mail.ReadWrite.Shared`
Forward email	Forwards email.	`Mail.Send`
Forward email from shared mailbox	Forwards email from shared mailbox.	`Mail.Send.Shared`
Get current user	Gets the connected user.	`User.Read`
Get email	Gets an email and downloads its attachments.	`Mail.ReadWrite` `Mail.Read.Shared` `Files.Read.All`
Get person profile	Gets a person profile from the directory.	`User.Read.All`
List categories	Lists categories.	`MailboxSettings.Read`
List contact folders	Lists contact folders.	`Contacts.Read`
List contacts	Lists contacts.	`Contacts.Read`
List drafts	Lists drafts.	`Mail.ReadWrite`
List drafts in shared mailbox	Lists drafts in shared mailbox.	`Mail.Read.Shared`
List folders	Lists folders.	`Mail.ReadWrite` `Mail.Read.Shared`
Mark email read status	Updates email read status.	`Mail.ReadWrite`
Mark email read status in shared mailbox	Updates email read status in shared mailbox.	`Mail.ReadWrite.Shared`
Move email to folder	Moves email to folder.	`Mail.ReadWrite` `Mail.ReadWrite.Shared`
Remove category from email	Removes category from email.	`Mail.ReadWrite` `Mail.ReadWrite.Shared`
Resolve contact	Resolves contact.	`Contacts.Read`
Resolve contact folder	Resolves contact folder.	`Contacts.Read`
Resolve draft	Resolves draft.	`Mail.ReadWrite` `Mail.Read.Shared`
Resolve email	Resolves email.	`Mail.ReadWrite` `Mail.Read.Shared`
Resolve folder	Resolves folder.	`Mail.ReadWrite` `Mail.Read.Shared`
Search own emails	Searches the connected mailbox.	`Mail.ReadWrite`
Search people	Searches the organization directory and contacts.	`People.Read`
Search shared email folders	Searches folders in a shared mailbox.	`Mail.Read.Shared`
Send draft	Sends draft.	`Mail.Send`
Send draft from shared mailbox	Sends draft from shared mailbox.	`Mail.Send.Shared`
Send email	Sends email.	`Mail.ReadWrite` `Mail.Send`
Send email from shared mailbox or other user	Sends email from another user or shared mailbox.	`Mail.Send.Shared`
Send reply	Sends a reply to an email.	`Mail.ReadWrite` `Mail.Send`
Send reply from shared mailbox	Sends a reply from a shared mailbox.	`Mail.ReadWrite.Shared` `Mail.Send.Shared`
Update draft	Updates draft.	`Mail.ReadWrite`
Update draft in shared mailbox	Updates draft in shared mailbox.	`Mail.ReadWrite.Shared`