Microsoft · OAuth Scopes

Microsoft OAuth Scopes

OAuth 2.0 derived

Microsoft publishes 42 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 API on a user’s behalf.

Tokens are issued from https://app.vssps.visualstudio.com/oauth2/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.

Fortune 100
Scopes: 42 Flows: authorizationCode, clientCredentials Method: derived

OAuth endpoints

Authorization URL
https://app.vssps.visualstudio.com/oauth2/authorize https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL
https://app.vssps.visualstudio.com/oauth2/token https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token https://login.microsoftonline.com/common/oauth2/v2.0/token https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token
Flows
authorizationCodeclientCredentials

Scopes (42)

ScopeDescriptionFlows
Application.Read.All Read all applications authorizationCode
Application.ReadWrite.All Read and write all applications authorizationCode, clientCredentials
Calendars.Read Read user calendars authorizationCode
Calendars.ReadWrite Read and write user calendars authorizationCode
Channel.ReadBasic.All Read channel names and descriptions authorizationCode
ChannelMessage.Read.All Read all channel messages authorizationCode
ChannelMessage.Send Send channel messages authorizationCode
Contacts.Read Read user contacts authorizationCode
Contacts.ReadWrite Read and write user contacts authorizationCode
DeviceManagementApps.Read.All Read mobile apps clientCredentials
DeviceManagementConfiguration.Read.All Read device configurations clientCredentials
DeviceManagementManagedDevices.Read.All Read managed devices clientCredentials
DeviceManagementManagedDevices.ReadWrite.All Read and write managed devices clientCredentials
Directory.ReadWrite.All Read and write directory data clientCredentials
Files.Read Read user files authorizationCode
Files.Read.All Read all files that user can access authorizationCode
Files.ReadWrite Read and write user files authorizationCode
Files.ReadWrite.All Full access to all files authorizationCode
Group.Read.All Read all groups authorizationCode
Group.ReadWrite.All Read and write all groups authorizationCode
Mail.Read Read user mail authorizationCode
Mail.ReadWrite Read and write user mail authorizationCode
Mail.Send Send mail as a user authorizationCode
Sites.Read.All Read items in all site collections authorizationCode
Sites.ReadWrite.All Read and write items in all site collections authorizationCode
Team.Create Create teams authorizationCode
Team.ReadBasic.All Read the names and descriptions of teams authorizationCode
TeamMember.Read.All Read team members authorizationCode
User.Read Read the signed-in user's profile authorizationCode
User.Read.All Read all users' full profiles authorizationCode
User.ReadWrite Read and update the signed-in user's profile authorizationCode
User.ReadWrite.All Read and write all users' full profiles authorizationCode
https://analysis.windows.net/powerbi/api/.default Access Power BI authorizationCode
https://cognitiveservices.azure.com/.default Access Azure OpenAI clientCredentials
https://graph.microsoft.com/.default Access Microsoft Graph clientCredentials
https://management.azure.com/.default Access Azure Resource Manager clientCredentials
https://org.api.crm.dynamics.com/.default Access Dynamics 365 authorizationCode
https://org.crm.dynamics.com/.default Access Dataverse authorizationCode
vso.build_execute Execute builds authorizationCode
vso.code Read source code authorizationCode
vso.project Read projects authorizationCode
vso.work_write Read and write work items authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

Raw ↑ 
generated: '2026-07-11'
method: derived
source: openapi/microsoft-azure-devops-openapi.yml, openapi/microsoft-azure-openai-openapi.yml,
  openapi/microsoft-azure-rest-openapi.yml, openapi/microsoft-dynamics-365-openapi.yml, openapi/microsoft-entra-id-openapi.yml,
  openapi/microsoft-graph-openapi.yml, openapi/microsoft-intune-openapi.yml, openapi/microsoft-onedrive-openapi.yml,
  openapi/microsoft-outlook-openapi.yml, openapi/microsoft-power-bi-openapi.yml, openapi/microsoft-power-platform-openapi.yml,
  openapi/microsoft-sharepoint-openapi.yml, openapi/microsoft-teams-openapi.yml
schemes:
- name: oauth2
  source: openapi/microsoft-azure-devops-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://app.vssps.visualstudio.com/oauth2/authorize
    tokenUrl: https://app.vssps.visualstudio.com/oauth2/token
  description: Microsoft Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-azure-openai-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token
  description: Microsoft Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-azure-rest-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token
  description: Microsoft Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-dynamics-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
  description: Microsoft Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-entra-id-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token
  description: Microsoft Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-graph-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/{tenant}/oauth2/v2.0/token
  description: Microsoft identity platform OAuth 2.0 authorization
- name: oauth2
  source: openapi/microsoft-intune-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token
  description: Microsoft Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-onedrive-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: OAuth 2.0 via Microsoft identity platform
- name: oauth2
  source: openapi/microsoft-outlook-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 Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-power-bi-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 Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-power-platform-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 Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-sharepoint-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 Entra ID OAuth 2.0
- name: oauth2
  source: openapi/microsoft-teams-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: OAuth 2.0 via Microsoft identity platform
scopes:
- scope: Application.Read.All
  description: Read all applications
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
- scope: Application.ReadWrite.All
  description: Read and write all applications
  flows:
  - authorizationCode
  - clientCredentials
  sources:
  - openapi/microsoft-entra-id-openapi.yml
  - openapi/microsoft-graph-openapi.yml
- scope: Calendars.Read
  description: Read user calendars
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-outlook-openapi.yml
- scope: Calendars.ReadWrite
  description: Read and write user calendars
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-outlook-openapi.yml
- scope: Channel.ReadBasic.All
  description: Read channel names and descriptions
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-teams-openapi.yml
- scope: ChannelMessage.Read.All
  description: Read all channel messages
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-teams-openapi.yml
- scope: ChannelMessage.Send
  description: Send channel messages
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-teams-openapi.yml
- scope: Contacts.Read
  description: Read user contacts
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-outlook-openapi.yml
- scope: Contacts.ReadWrite
  description: Read and write user contacts
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-outlook-openapi.yml
- scope: DeviceManagementApps.Read.All
  description: Read mobile apps
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-intune-openapi.yml
- scope: DeviceManagementConfiguration.Read.All
  description: Read device configurations
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-intune-openapi.yml
- scope: DeviceManagementManagedDevices.Read.All
  description: Read managed devices
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-intune-openapi.yml
- scope: DeviceManagementManagedDevices.ReadWrite.All
  description: Read and write managed devices
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-intune-openapi.yml
- scope: Directory.ReadWrite.All
  description: Read and write directory data
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-entra-id-openapi.yml
- scope: Files.Read
  description: Read user files
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-onedrive-openapi.yml
- scope: Files.Read.All
  description: Read all files that user can access
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-onedrive-openapi.yml
- scope: Files.ReadWrite
  description: Read and write user files
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-onedrive-openapi.yml
- scope: Files.ReadWrite.All
  description: Full access to all files
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-onedrive-openapi.yml
- scope: Group.Read.All
  description: Read all groups
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
- scope: Group.ReadWrite.All
  description: Read and write all groups
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
- scope: Mail.Read
  description: Read user mail
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-outlook-openapi.yml
- scope: Mail.ReadWrite
  description: Read and write user mail
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-outlook-openapi.yml
- scope: Mail.Send
  description: Send mail as a user
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-outlook-openapi.yml
- scope: Sites.Read.All
  description: Read items in all site collections
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-sharepoint-openapi.yml
- scope: Sites.ReadWrite.All
  description: Read and write items in all site collections
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-sharepoint-openapi.yml
- scope: Team.Create
  description: Create teams
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-teams-openapi.yml
- scope: Team.ReadBasic.All
  description: Read the names and descriptions of teams
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
  - openapi/microsoft-teams-openapi.yml
- scope: TeamMember.Read.All
  description: Read team members
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-teams-openapi.yml
- scope: User.Read
  description: Read the signed-in user's profile
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
- scope: User.Read.All
  description: Read all users' full profiles
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
- scope: User.ReadWrite
  description: Read and update the signed-in user's profile
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
- scope: User.ReadWrite.All
  description: Read and write all users' full profiles
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-graph-openapi.yml
- scope: https://analysis.windows.net/powerbi/api/.default
  description: Access Power BI
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-power-bi-openapi.yml
- scope: https://cognitiveservices.azure.com/.default
  description: Access Azure OpenAI
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-azure-openai-openapi.yml
- scope: https://graph.microsoft.com/.default
  description: Access Microsoft Graph
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-entra-id-openapi.yml
  - openapi/microsoft-graph-openapi.yml
- scope: https://management.azure.com/.default
  description: Access Azure Resource Manager
  flows:
  - clientCredentials
  sources:
  - openapi/microsoft-azure-rest-openapi.yml
- scope: https://org.api.crm.dynamics.com/.default
  description: Access Dynamics 365
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-dynamics-365-openapi.yml
- scope: https://org.crm.dynamics.com/.default
  description: Access Dataverse
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-power-platform-openapi.yml
- scope: vso.build_execute
  description: Execute builds
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-azure-devops-openapi.yml
- scope: vso.code
  description: Read source code
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-azure-devops-openapi.yml
- scope: vso.project
  description: Read projects
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-azure-devops-openapi.yml
- scope: vso.work_write
  description: Read and write work items
  flows:
  - authorizationCode
  sources:
  - openapi/microsoft-azure-devops-openapi.yml

Work with this as data

Every scope set here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for oauth scopes

4 MCP tools reach this
  • find_scopesBrowse and filter every scope set in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This scope set 
curl "https://apis.io/api/v1/scopes/microsoft-scopes"
All oauth scopes 
curl "https://apis.io/api/v1/scopes?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.