> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook Email

> Review the validated minimum OAuth scopes for every Outlook Email action.

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

<Warning>
  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`.
</Warning>

## Minimal scopes per action

<Note>
  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.
</Note>

<div style={{overflowX: "auto"}}>
  <table style={{width: "100%", maxWidth: "100%", minWidth: 0, tableLayout: "fixed", whiteSpace: "normal", overflowWrap: "anywhere", wordBreak: "break-word"}}>
    <colgroup>
      <col style={{width: "22%"}} />

      <col style={{width: "28%"}} />

      <col style={{width: "50%"}} />
    </colgroup>

    <thead>
      <tr>
        <th style={{width: "22%"}}>Action</th>
        <th style={{width: "28%"}}>Description</th>
        <th style={{width: "50%"}}>Minimum scopes</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td><strong>Add category to email</strong></td>
        <td>Adds category to email.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Create contact</strong></td>
        <td>Creates contact.</td>
        <td><code>Contacts.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Create draft</strong></td>
        <td>Creates draft.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Create draft in shared mailbox</strong></td>
        <td>Creates draft in shared mailbox.</td>
        <td><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Create folder</strong></td>
        <td>Creates folder.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Create folder in shared mailbox</strong></td>
        <td>Creates folder in shared mailbox.</td>
        <td><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Draft reply to message</strong></td>
        <td>Draft reply to message.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Draft reply to message in shared mailbox</strong></td>
        <td>Draft reply to message in shared mailbox.</td>
        <td><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Flag email</strong></td>
        <td>Flag email.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Flag email in shared mailbox</strong></td>
        <td>Flag email in shared mailbox.</td>
        <td><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Forward email</strong></td>
        <td>Forwards email.</td>
        <td><code>Mail.Send</code></td>
      </tr>

      <tr>
        <td><strong>Forward email from shared mailbox</strong></td>
        <td>Forwards email from shared mailbox.</td>
        <td><code>Mail.Send.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Get current user</strong></td>
        <td>Gets the connected user.</td>
        <td><code>User.Read</code></td>
      </tr>

      <tr>
        <td><strong>Get email</strong></td>
        <td>Gets an email and downloads its attachments.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.Read.Shared</code><br /><code>Files.Read.All</code></td>
      </tr>

      <tr>
        <td><strong>Get person profile</strong></td>
        <td>Gets a person profile from the directory.</td>
        <td><code>User.Read.All</code></td>
      </tr>

      <tr>
        <td><strong>List categories</strong></td>
        <td>Lists categories.</td>
        <td><code>MailboxSettings.Read</code></td>
      </tr>

      <tr>
        <td><strong>List contact folders</strong></td>
        <td>Lists contact folders.</td>
        <td><code>Contacts.Read</code></td>
      </tr>

      <tr>
        <td><strong>List contacts</strong></td>
        <td>Lists contacts.</td>
        <td><code>Contacts.Read</code></td>
      </tr>

      <tr>
        <td><strong>List drafts</strong></td>
        <td>Lists drafts.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>List drafts in shared mailbox</strong></td>
        <td>Lists drafts in shared mailbox.</td>
        <td><code>Mail.Read.Shared</code></td>
      </tr>

      <tr>
        <td><strong>List folders</strong></td>
        <td>Lists folders.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.Read.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Mark email read status</strong></td>
        <td>Updates email read status.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Mark email read status in shared mailbox</strong></td>
        <td>Updates email read status in shared mailbox.</td>
        <td><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Move email to folder</strong></td>
        <td>Moves email to folder.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Remove category from email</strong></td>
        <td>Removes category from email.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.ReadWrite.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Resolve contact</strong></td>
        <td>Resolves contact.</td>
        <td><code>Contacts.Read</code></td>
      </tr>

      <tr>
        <td><strong>Resolve contact folder</strong></td>
        <td>Resolves contact folder.</td>
        <td><code>Contacts.Read</code></td>
      </tr>

      <tr>
        <td><strong>Resolve draft</strong></td>
        <td>Resolves draft.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.Read.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Resolve email</strong></td>
        <td>Resolves email.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.Read.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Resolve folder</strong></td>
        <td>Resolves folder.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.Read.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Search own emails</strong></td>
        <td>Searches the connected mailbox.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Search people</strong></td>
        <td>Searches the organization directory and contacts.</td>
        <td><code>People.Read</code></td>
      </tr>

      <tr>
        <td><strong>Search shared email folders</strong></td>
        <td>Searches folders in a shared mailbox.</td>
        <td><code>Mail.Read.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Send draft</strong></td>
        <td>Sends draft.</td>
        <td><code>Mail.Send</code></td>
      </tr>

      <tr>
        <td><strong>Send draft from shared mailbox</strong></td>
        <td>Sends draft from shared mailbox.</td>
        <td><code>Mail.Send.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Send email</strong></td>
        <td>Sends email.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.Send</code></td>
      </tr>

      <tr>
        <td><strong>Send email from shared mailbox or other user</strong></td>
        <td>Sends email from another user or shared mailbox.</td>
        <td><code>Mail.Send.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Send reply</strong></td>
        <td>Sends a reply to an email.</td>
        <td><code>Mail.ReadWrite</code><br /><code>Mail.Send</code></td>
      </tr>

      <tr>
        <td><strong>Send reply from shared mailbox</strong></td>
        <td>Sends a reply from a shared mailbox.</td>
        <td><code>Mail.ReadWrite.Shared</code><br /><code>Mail.Send.Shared</code></td>
      </tr>

      <tr>
        <td><strong>Update draft</strong></td>
        <td>Updates draft.</td>
        <td><code>Mail.ReadWrite</code></td>
      </tr>

      <tr>
        <td><strong>Update draft in shared mailbox</strong></td>
        <td>Updates draft in shared mailbox.</td>
        <td><code>Mail.ReadWrite.Shared</code></td>
      </tr>
    </tbody>
  </table>
</div>

## Related pages

* [Microsoft Integration Scopes](/en/admin/manage-integrations/microsoft-integration-scopes)
* [Microsoft integrations: permissions and admin approval](/en/admin/manage-integrations/integration-setup-guides/microsoft)