@devries-cameron20 / composio Mirror · read-only / commits / 013bfced8
Fork 0

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

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 09:45 UTC

docs(kb): document SharePoint Graph tenant authentication

Brendan O'Leary committed Oct 13, 2026 at 02:07 UTC 013bfced8be3e58bc9107346351b2ed7b36907f2
3 files changed +89 -1
docs/content/kb/guide/toolkits-sharepoint.mdx
+44
@@ -10,6 +10,50 @@ topics: ["auth-config","authentication","errors-and-troubleshooting","sessions-a
10 toolkitSlugs: ["share_point"]
11 aliases: ["/kb/toolkits/after-certain-sharepoint-auth-fixes-create-a-new-auth-config-integrati","/kb/toolkits/sharepoint-troubleshooting","after-certain-sharepoint-auth-fixes-create-a-new-auth-config-integrati","create-folder-odata-type-name-error","disable-destructive-sharepoint-tools-with-destructivehint-or-explicit","set-the-sharepoint-tenant-on-the-connection","share-point-upload-from-url-needs-a-server-fetchable-url","sharepoint-rest-and-graph-need-separate-connections","sharepoint-rest-app-only-client-credentials-use-certificate-auth","sharepoint-teams-site-returns-404","sharepoint-troubleshooting","the-sharepoint-subsite-field-is-not-a-permission-boundary","use-share-point-search-query-for-kql-fql-sharepoint-search"]
12 ---
13 +## Use a tenant-specific Microsoft endpoint for SharePoint Graph
14 +
15 +Set `issuer` to your Microsoft Entra tenant ID to authenticate SharePoint Graph
16 +through that tenant's endpoint instead of `/common`. Use the directory (tenant)
17 +ID, not your SharePoint site name. Microsoft's [tenant authority
18 +reference](https://learn.microsoft.com/en-us/entra/identity-platform/v2-protocols-oidc#find-your-apps-openid-configuration-document-uri)
19 +explains how tenant-specific sign-in differs from `common`.
20 +
21 +First, retrieve the toolkit's authentication fields with your Composio project
22 +API key:
23 +
24 +```bash
25 +curl --fail-with-body \
26 + 'https://backend.composio.dev/api/v3.1/toolkits/sharepoint_graph' \
27 + -H 'x-api-key: <COMPOSIO_API_KEY>'
28 +```
29 +
30 +Find the `OAUTH2` auth scheme and inspect `fields.auth_config_creation` and
31 +`fields.connected_account_initiation`. The `issuer` field appears under
32 +`connected_account_initiation`.
33 +
34 +To apply the same tenant ID to new connections, [update your custom auth
35 +config](/reference/api-reference/auth-configs/patchAuthConfigsByNanoid) with
36 +`shared_credentials.issuer`:
37 +
38 +```bash
39 +curl --fail-with-body -X PATCH \
40 + 'https://backend.composio.dev/api/v3.1/auth_configs/<AUTH_CONFIG_ID>' \
41 + -H 'x-api-key: <COMPOSIO_API_KEY>' \
42 + -H 'content-type: application/json' \
43 + -d '{
44 + "type": "custom",
45 + "shared_credentials": {
46 + "issuer": "<MICROSOFT_TENANT_ID>"
47 + }
48 + }'
49 +```
50 +
51 +Replace `<AUTH_CONFIG_ID>` with your SharePoint Graph custom auth config ID.
52 +Every new connection created through this auth config inherits the tenant ID.
53 +Create a new connection using that config and complete Microsoft sign-in to use
54 +the tenant-specific endpoint. This recipe configures new connections; it does
55 +not migrate existing connected accounts.
56 +
57 ## SharePoint REST APIs and SharePoint Graph are separate API families
58
59 Treat the current SharePoint toolkit and the SharePoint Graph toolkit as separate API families, not as interchangeable variants of the same connection.
docs/kb/articles/toolkits-sharepoint.md
+44
@@ -1,3 +1,47 @@
1 +## Use a tenant-specific Microsoft endpoint for SharePoint Graph
2 +
3 +Set `issuer` to your Microsoft Entra tenant ID to authenticate SharePoint Graph
4 +through that tenant's endpoint instead of `/common`. Use the directory (tenant)
5 +ID, not your SharePoint site name. Microsoft's [tenant authority
6 +reference](https://learn.microsoft.com/en-us/entra/identity-platform/v2-protocols-oidc#find-your-apps-openid-configuration-document-uri)
7 +explains how tenant-specific sign-in differs from `common`.
8 +
9 +First, retrieve the toolkit's authentication fields with your Composio project
10 +API key:
11 +
12 +```bash
13 +curl --fail-with-body \
14 + 'https://backend.composio.dev/api/v3.1/toolkits/sharepoint_graph' \
15 + -H 'x-api-key: <COMPOSIO_API_KEY>'
16 +```
17 +
18 +Find the `OAUTH2` auth scheme and inspect `fields.auth_config_creation` and
19 +`fields.connected_account_initiation`. The `issuer` field appears under
20 +`connected_account_initiation`.
21 +
22 +To apply the same tenant ID to new connections, [update your custom auth
23 +config](/reference/api-reference/auth-configs/patchAuthConfigsByNanoid) with
24 +`shared_credentials.issuer`:
25 +
26 +```bash
27 +curl --fail-with-body -X PATCH \
28 + 'https://backend.composio.dev/api/v3.1/auth_configs/<AUTH_CONFIG_ID>' \
29 + -H 'x-api-key: <COMPOSIO_API_KEY>' \
30 + -H 'content-type: application/json' \
31 + -d '{
32 + "type": "custom",
33 + "shared_credentials": {
34 + "issuer": "<MICROSOFT_TENANT_ID>"
35 + }
36 + }'
37 +```
38 +
39 +Replace `<AUTH_CONFIG_ID>` with your SharePoint Graph custom auth config ID.
40 +Every new connection created through this auth config inherits the tenant ID.
41 +Create a new connection using that config and complete Microsoft sign-in to use
42 +the tenant-specific endpoint. This recipe configures new connections; it does
43 +not migrate existing connected accounts.
44 +
45 ## SharePoint REST APIs and SharePoint Graph are separate API families
46
47 Treat the current SharePoint toolkit and the SharePoint Graph toolkit as separate API families, not as interchangeable variants of the same connection.
docs/kb/manifest.json
+1 -1
@@ -5382,7 +5382,7 @@
5382 ],
5383 "relatedGuides": [],
5384 "externalResources": [],
5385 - "updatedAt": "2026-07-16",
5385 + "updatedAt": "2026-10-13",
5386 "lastVerifiedAt": "2026-08-12",
5387 "reviewAfter": "2026-11-10",
5388 "freshness": "evergreen",