Microsoft Outlook OAuth Scopes

OAuth 2.0 derived

Microsoft Outlook publishes 6 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Microsoft Outlook API on a user’s behalf.

Tokens are issued from https://login.microsoftonline.com/common/oauth2/v2.0/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

CalendarContactsEmailEnterpriseMicrosoftOffice 365Productivity

Scopes: 6 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Token URL
https://login.microsoftonline.com/common/oauth2/v2.0/token

Flows
authorizationCode

Scopes (6)

Scope	Description	Flows
Mail.Read	Read user mail	authorizationCode
Mail.Read.Shared	Read mail in shared mailboxes	authorizationCode
Mail.ReadBasic	Read user basic mail	authorizationCode
Mail.ReadWrite	Read and write access to user mail	authorizationCode
Mail.ReadWrite.Shared	Read and write mail in shared mailboxes	authorizationCode
Mail.Send	Send mail as a user	authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-07-11'
method: derived
source: openapi/microsoft-graph-mail-api-openapi.yml
schemes:
- name: oauth2
  source: openapi/microsoft-graph-mail-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
    tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
  description: Microsoft identity platform OAuth 2.0 authorization. Supports delegated (user)
    and application permissions.
scopes:
- scope: Mail.Read
  description: Read user mail
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-mail-api-openapi.yml
- scope: Mail.Read.Shared
  description: Read mail in shared mailboxes
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-mail-api-openapi.yml
- scope: Mail.ReadBasic
  description: Read user basic mail
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-mail-api-openapi.yml
- scope: Mail.ReadWrite
  description: Read and write access to user mail
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-mail-api-openapi.yml
- scope: Mail.ReadWrite.Shared
  description: Read and write mail in shared mailboxes
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-mail-api-openapi.yml
- scope: Mail.Send
  description: Send mail as a user
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-mail-api-openapi.yml