Skip to content

Commit b1060ef

Browse files
authored
Document Microsoft scopes required by Arcade toolkits (#409)
document scopes required in MS oauth app for all MS toolkits
1 parent e95527a commit b1060ef

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

pages/home/auth-providers/microsoft.mdx

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,12 +34,23 @@ Before showing how to configure your Microsoft app credentials, let's go through
3434
### Create a Microsoft app
3535

3636
- 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)
37-
- Choose the permissions (scopes) you need for your app
37+
- 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.
3838
- Set the redirect URL to: `https://cloud.arcade.dev/api/v1/oauth/callback`
3939
- Copy the client ID and client secret to use below
4040

4141
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).
4242

43+
### Arcade Microsoft Toolkits Scopes
44+
45+
Below is the list of scopes required by the Arcade Microsoft Toolkits:
46+
47+
| Toolkit | Required Permissions |
48+
|---------|---------------------|
49+
| [Outlook Calendar](/toolkits/productivity/outlook_calendar) | `Calendars.ReadBasic`<br/>`Calendars.ReadWrite`<br/>`MailboxSettings.Read` |
50+
| [Outlook Mail](/toolkits/productivity/outlook_mail) | `Mail.Read`<br/>`Mail.ReadWrite`<br/>`Mail.Send` |
51+
| [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` |
52+
| [SharePoint](/toolkits/productivity/sharepoint) | `Sites.Read.All` |
53+
4354
## Configuring your own Microsoft Auth Provider in Arcade
4455

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

0 commit comments

Comments
 (0)