Skip to content

Document Microsoft scopes required by Arcade toolkits #409

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 15, 2025
Merged

Document Microsoft scopes required by Arcade toolkits #409

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion pages/home/auth-providers/microsoft.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,12 +34,23 @@ Before showing how to configure your Microsoft app credentials, let's go through
### Create a Microsoft app

- Follow Microsoft's guide to [registering an app with the Microsoft identity platform](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app)
- Choose the permissions (scopes) you need for your app
- Choose the permissions (scopes) you need for your app. Refer to the [section below](#arcade-microsoft-toolkits-scopes) for a list of scopes needed by the Arcade Microsoft Toolkits, in case you intend to use them.
- Set the redirect URL to: `https://cloud.arcade.dev/api/v1/oauth/callback`
- Copy the client ID and client secret to use below

Next, add the Microsoft app to your Arcade Engine configuration. You can do this in the Arcade Dashboard, or by editing the `engine.yaml` file directly (for a self-hosted instance).

### Arcade Microsoft Toolkits Scopes

Below is the list of scopes required by the Arcade Microsoft Toolkits:

| Toolkit | Required Permissions |
|---------|---------------------|
| [Outlook Calendar](/toolkits/productivity/outlook_calendar) | `Calendars.ReadBasic`<br/>`Calendars.ReadWrite`<br/>`MailboxSettings.Read` |
| [Outlook Mail](/toolkits/productivity/outlook_mail) | `Mail.Read`<br/>`Mail.ReadWrite`<br/>`Mail.Send` |
| [Teams](/toolkits/social-communication/microsoft_teams) | `Channel.ReadBasic.All`<br/>`ChannelMessage.Read.All`<br/>`ChannelMessage.Send`<br/>`Chat.Create`<br/>`Chat.Read`<br/>`ChatMessage.Read`<br/>`ChatMessage.Send`<br/>`People.Read`<br/>`Team.ReadBasic.All`<br/>`TeamMember.Read.All`<br/>`User.Read` |
| [SharePoint](/toolkits/productivity/sharepoint) | `Sites.Read.All` |

## Configuring your own Microsoft Auth Provider in Arcade

There are two ways to configure your Microsoft app credentials in Arcade:
Expand Down