Microsoft 365 · OAuth Scopes

Microsoft 365 OAuth Scopes

OAuth 2.0 derived

Microsoft 365 publishes 8 OAuth 2.0 scopes via the authorizationCode and clientCredentials flows. Scopes are the fine-grained permissions an application requests at authorization time to act against the Microsoft 365 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.

ProductivityCollaborationEmailCalendarFilesIdentityMicrosoftMicrosoft Graph

Scopes: 8 Flows: authorizationCode, clientCredentials 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
authorizationCodeclientCredentials

Scopes (8)

Scope	Description	Flows
Calendars.Read	Read user calendars	authorizationCode
Channel.ReadBasic.All	Read basic channel info	authorizationCode
Files.Read.All	Read all files	authorizationCode
Group.Read.All	Read all groups	authorizationCode
Mail.Read	Read user mail	authorizationCode
User.Read	Sign in and read user profile	authorizationCode
User.ReadWrite.All	Read and write all users' full profiles	authorizationCode
https://graph.microsoft.com/.default	Use app-registered Graph permissions	clientCredentials

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-07-11'
method: derived
source: openapi/microsoft-365-openapi.yml
schemes:
- name: oauth2
  source: openapi/microsoft-365-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
  - flow: clientCredentials
    tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
  description: Microsoft Entra ID OAuth 2.0
scopes:
- scope: Calendars.Read
  description: Read user calendars
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-365-openapi.yml
- scope: Channel.ReadBasic.All
  description: Read basic channel info
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-365-openapi.yml
- scope: Files.Read.All
  description: Read all files
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-365-openapi.yml
- scope: Group.Read.All
  description: Read all groups
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-365-openapi.yml
- scope: Mail.Read
  description: Read user mail
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-365-openapi.yml
- scope: User.Read
  description: Sign in and read user profile
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-365-openapi.yml
- scope: User.ReadWrite.All
  description: Read and write all users' full profiles
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-365-openapi.yml
- scope: https://graph.microsoft.com/.default
  description: Use app-registered Graph permissions
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-365-openapi.yml