Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
md 91 lines 6.87 KB
Rendered Raw
1 ## How do I set up custom OAuth credentials for Microsoft PowerPoint?
2
3 Use your own Microsoft Entra ID app registration when you want the Microsoft consent screen to show your app's name and you want to control which permissions Microsoft PowerPoint requests.
4
5 ### Create the Microsoft Entra app
6
7 1. Sign in to the [Azure portal](https://portal.azure.com/), open **App registrations**, and click **New registration**.
8
9 ![Azure App registrations page with the New registration button](/images/toolkits/shared/5uRKMRjmfWRjXAIPnkdZ8jDIX4.webp)
10
11 2. Enter a **Name**. Under **Supported account types**, choose **Accounts in any organizational directory and personal Microsoft accounts** (shown as **Any Entra ID Tenant + Personal Microsoft accounts**) if you want to connect both work or school and personal accounts. Choose a single-tenant or multitenant organizational option if you only connect work or school accounts.
12 3. Under **Redirect URI**, select the **Web** platform, enter `https://backend.composio.dev/api/v1/auth-apps/add`, and click **Register**.
13
14 ![Entra Register an application form with Any Entra ID Tenant + Personal Microsoft accounts, the Web platform and the Composio redirect URI](/images/toolkits/microsoft_powerpoint/register-application.webp)
15
16 4. On the app's **Overview** page, copy the **Application (client) ID**.
17
18 ![Entra app Overview page with the client, object and tenant IDs censored](/images/toolkits/microsoft_powerpoint/app-overview.webp)
19
20 5. Open **Certificates & secrets** and click **New client secret**. Add a description, choose an expiry that fits your rotation policy (for example, 180 days), and click **Add**. Rotate the secret before it expires.
21
22 ![Certificates & secrets page with the New client secret button](/images/toolkits/microsoft_powerpoint/certificates-and-secrets.webp)
23
24 ![Add a client secret panel with a description and the 180-day expiry](/images/toolkits/microsoft_powerpoint/add-client-secret.webp)
25
26 6. Copy the secret **Value** right away. Use the **Value**, not the **Secret ID**. Azure shows the full value only once; if you lose it, create a new secret.
27
28 ![Client secrets list with the Value and Secret ID censored](/images/toolkits/microsoft_powerpoint/client-secret-value.webp)
29
30 7. Open **API permissions**, click **Add a permission**, select **Microsoft Graph**, and choose **Delegated permissions** so the app acts as the signed-in user. Add `Files.ReadWrite.All` (create, read, and edit presentations) and `offline_access` (refresh tokens). `User.Read` is already listed by default, then click **Add permissions**.
31
32 ![API permissions page with the Add a permission button](/images/toolkits/microsoft_powerpoint/api-permissions.webp)
33
34 ![Request API permissions panel with Microsoft Graph under Microsoft APIs](/images/toolkits/microsoft_powerpoint/microsoft-graph-api.webp)
35
36 ![Microsoft Graph permission type choice with Delegated permissions](/images/toolkits/microsoft_powerpoint/delegated-permissions.webp)
37
38 ![Microsoft Graph delegated permissions with Files.ReadWrite.All selected](/images/toolkits/microsoft_powerpoint/files-readwrite-all-permission.webp)
39
40 ![Microsoft Graph delegated permissions with offline_access selected](/images/toolkits/microsoft_powerpoint/offline-access-permission.webp)
41
42 ![Configured permissions list with Files.ReadWrite.All, offline_access and User.Read](/images/toolkits/microsoft_powerpoint/configured-permissions.webp)
43
44 8. If your tenant restricts user consent, have a tenant admin click **Grant admin consent for** your tenant on the **API permissions** page. Adding a permission to the app registration doesn't grant consent by itself.
45
46 The redirect URI you register must exactly match the `oauth_redirect_uri` field in your Composio auth config (default `https://backend.composio.dev/api/v1/auth-apps/add`).
47
48 ![Entra Authentication page listing the Composio Web redirect URI](/images/toolkits/microsoft_powerpoint/registered-redirect-uri.webp)
49
50 ### Create the auth config in Composio
51
52 1. In the Composio dashboard, go to **Auth Configs**, click **Create**, and select **Microsoft PowerPoint**. Enter a config name and click **Next**.
53
54 ![Composio Auth Configs page with the Create button](/images/toolkits/microsoft_powerpoint/composio-auth-configs.webp)
55
56 ![Create Auth Config dialog with Microsoft PowerPoint selected](/images/toolkits/microsoft_powerpoint/composio-toolkit-picker.webp)
57
58 ![Auth config name field with the Next button](/images/toolkits/microsoft_powerpoint/composio-config-name.webp)
59
60 2. Select **OAuth 2.0** and **Your Own Credentials**. Paste the Application (client) ID into **Client id** and the secret value into **Client secret**. Leave **Redirect URI** as shown.
61
62 ![Composio OAuth 2.0 form with empty Client id and Client secret fields and the v1 redirect URI](/images/toolkits/microsoft_powerpoint/composio-oauth-credentials.webp)
63
64 ![Composio auth config with censored credentials and the v1 redirect URI](/images/toolkits/microsoft_powerpoint/composio-credentials-entered.webp)
65
66 3. Under **Scopes**, select the same permissions you added in Azure, then click **Create Auth Config**.
67
68 ![Composio scopes list with Files.ReadWrite.All and offline_access selected](/images/toolkits/microsoft_powerpoint/composio-scopes.webp)
69
70 4. Open the auth config and click **Connect Account**. Sign in with the Microsoft account you want to connect and click **Accept**. Leave **Consent on behalf of your organization** unchecked unless you're an admin granting tenant-wide consent. An **unverified** label is expected for a custom app without a verified publisher.
71
72 ![Microsoft PowerPoint auth config panel with the Connect Account button](/images/toolkits/microsoft_powerpoint/composio-connect-account.webp)
73
74 ![Microsoft Pick an account page with the accounts censored](/images/toolkits/shared/Ad4GMrYjKLi22dWKFlwp1NGTs.webp)
75
76 ![Microsoft consent prompt for file access with organization consent unchecked](/images/toolkits/microsoft_powerpoint/microsoft-consent.webp)
77
78 5. Back on the auth config's **Connected Accounts** tab, confirm the account shows **Active**. The **Enabled** label at the top of the page describes the auth config, not the account.
79
80 ![Auth config Accounts tab with the PowerPoint account showing Active](/images/toolkits/microsoft_powerpoint/connected-account-active.webp)
81
82 For the general flow, see [custom auth configs](/docs/auth-configuration/custom-auth-configs).
83
84 ### Scopes
85
86 The default auth config requests `Files.ReadWrite.All` and `offline_access`. PowerPoint calls go through Microsoft Graph at `https://graph.microsoft.com/v1.0/`.
87
88 ### Revoke access
89
90 - In Composio, delete the connected account from the auth config, or disable the auth config.
91 - In Microsoft, work or school users remove the app at [myapps.microsoft.com](https://myapps.microsoft.com/), and personal account users remove it at [account.microsoft.com/privacy/app-access](https://account.microsoft.com/privacy/app-access). This revokes PowerPoint's access.