Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs(auth): clarify managed OAuth app coverage
Brendan O'Leary committed
Aug 31, 2026 at 22:01 UTC
985d0d0777bb0bb0183adf897cc7db590d9904fb
6 files changed
+46
-56
docs/app/llms.mdx/[[...slug]]/route.ts
+15
-9
@@ -854,7 +854,7 @@ function toolkitToMarkdown(
854
'',
855
`- **Category:** ${toolkit.category || 'Uncategorized'}`,
856
`- **Auth:** ${toolkit.authSchemes.join(', ') || 'None'}`,
857
- `- **Composio Managed App Available?** ${
857
+ `- **Composio-managed OAuth available?** ${
858
toolkit.authSchemes?.some(s => s.toUpperCase().includes('OAUTH'))
859
? toolkit.composioManagedAuthSchemes && toolkit.composioManagedAuthSchemes.length > 0
860
? 'Yes'
@@ -949,20 +949,26 @@ async function generateManagedAuthIndex(): Promise<string> {
949
.sort((a, b) => (a.name?.trim() || '').localeCompare(b.name?.trim() || ''));
950
951
const lines: string[] = [
952
- '# Composio Managed Auth',
952
+ '# Managed OAuth apps',
953
'',
954
- 'Toolkits with managed auth work out of the box with no OAuth setup. For toolkits without managed auth, you need to provide your own credentials.',
954
+ 'Composio can provide the OAuth app that your users authorize when they connect a toolkit. You do not need to register an OAuth app or supply its client ID and client secret.',
955
'',
956
- 'You can also check programmatically whether a toolkit has managed auth:',
956
+ 'This list covers only toolkits that support OAuth. It does not include toolkits that use only API keys, bearer tokens, Basic auth, or no authentication.',
957
+ '',
958
+ 'Call the toolkit endpoint and read `composio_managed_auth_schemes`:',
959
'',
960
'```bash',
959
- "curl 'https://backend.composio.dev/api/v3/toolkits/posthog' \\",
961
+ "curl 'https://backend.composio.dev/api/v3.1/toolkits/gmail' \\",
962
" -H 'x-api-key: YOUR_API_KEY'",
963
'```',
964
'',
963
- 'See [When to use your own developer credentials](/docs/authentication/custom-app-vs-managed-app.md) for help deciding which approach fits your use case.',
965
+ 'If `composio_managed_auth_schemes` contains the toolkit\'s OAuth method, Composio provides the OAuth app. If the field does not contain that method, register your own OAuth app and supply its client ID and client secret.',
966
+ '',
967
+ 'Some toolkits support more than one authentication method. A toolkit appears under **Composio-managed OAuth available** when Composio manages at least one OAuth method. Open the toolkit page to check each method.',
968
+ '',
969
+ 'See [Managed vs custom auth](/docs/authentication/custom-app-vs-managed-app.md) for setup steps and trade-offs.',
970
'',
965
- `## Composio Managed App Available (${managed.length})`,
971
+ `## Composio-managed OAuth available (${managed.length})`,
972
'',
973
'| Toolkit | Slug |',
974
'|---------|------|',
@@ -975,7 +981,7 @@ async function generateManagedAuthIndex(): Promise<string> {
981
}
982
983
lines.push('');
978
- lines.push(`## Requires Your Own Credentials (${unmanaged.length})`);
984
+ lines.push(`## Bring your own OAuth app (${unmanaged.length})`);
985
lines.push('');
986
lines.push('| Toolkit | Slug |');
987
lines.push('|---------|------|');
@@ -1004,7 +1010,7 @@ async function generateToolkitsIndex(): Promise<string> {
1010
`Composio supports ${toolkits.length} toolkits for building AI agents.`,
1011
'',
1012
'- [Premium Tools](/toolkits/pro-tools.md) - Which tools cost extra, how they are priced, and what the limits are',
1007
- '- [Composio Managed Auth](/toolkits/managed-auth.md) - Full list of OAuth toolkits that work out of the box vs ones that need your own credentials',
1013
+ '- [Managed OAuth apps](/toolkits/managed-auth.md) - Check whether Composio provides the OAuth app for a toolkit',
1014
'',
1015
'## All Toolkits',
1016
'',
docs/components/toolkits/auth-details-section.tsx
+2
-2
@@ -87,12 +87,12 @@ export function AuthDetailsSection({ authConfigDetails, authSchemes, composioMan
87
className="inline-flex items-center gap-1.5 border border-fd-border bg-fd-card px-2 py-0.5 font-mono text-[10px] uppercase tracking-[0.06em] text-fd-foreground transition-colors hover:border-fd-foreground/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring"
88
>
89
<span className="size-1.5 rounded-full bg-green-500" aria-hidden="true" />
90
- Composio Managed App available
90
+ Composio-managed OAuth available
91
<ArrowUpRight className="size-3" aria-hidden="true" />
92
</Link>
93
) : (
94
<span className="rounded bg-amber-500/10 px-2 py-0.5 text-xs font-medium text-amber-600 dark:text-amber-400">
95
- Composio Managed App not available
95
+ Composio-managed OAuth not available
96
</span>
97
)
98
)}
docs/components/toolkits/managed-auth-list.tsx
+2
-2
@@ -173,7 +173,7 @@ export function ManagedAuthList() {
173
}`}
174
>
175
<span className="inline-block h-2 w-2 rounded-full bg-green-500" />
176
- Composio Managed App Available
176
+ Composio-managed OAuth available
177
<span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>
178
</button>
179
<button
@@ -185,7 +185,7 @@ export function ManagedAuthList() {
185
}`}
186
>
187
<span className="inline-block h-2 w-2 rounded-full bg-fd-muted-foreground/60" />
188
- Requires your own credentials
188
+ Bring your own OAuth app
189
<span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>
190
</button>
191
</div>
docs/components/toolkits/toolkits-landing.tsx
+1
-1
@@ -181,7 +181,7 @@ export function ToolkitsLanding() {
181
182
{/* Cards */}
183
<Cards>
184
- <Card icon={<ShieldCheck />} title="Composio Managed Auth" href="/toolkits/managed-auth" description="Check which toolkits have managed auth" />
184
+ <Card icon={<ShieldCheck />} title="Managed OAuth apps" href="/toolkits/managed-auth" description="Check which toolkits have managed OAuth" />
185
<Card icon={<Sparkles />} title="Premium Tools" href="/toolkits/pro-tools" description="Learn about pricing and limits" />
186
<Card icon={<Wrench />} title="Meta Tools" href="/toolkits/meta-tools" description="The system tools every session gives your agent" />
187
</Cards>
docs/content/docs/authentication/custom-app-vs-managed-app.mdx
+4
-4
@@ -6,14 +6,14 @@ keywords: [custom auth config, managed auth, oauth, auth config, white label, ow
6
7
Composio supports two ways to authenticate users with toolkits.
8
9
-- **[Composio managed apps](/toolkits/managed-auth)**: Composio registers and maintains OAuth apps for popular toolkits (GitHub, Gmail, Slack, etc.). Zero setup, works out of the box.
9
+- **[Composio managed apps](/toolkits/managed-auth)**: Composio registers and maintains OAuth apps for popular toolkits such as GitHub, Gmail, and Slack. You do not need to register your own OAuth app.
10
- **Custom auth configs**: You provide your own OAuth app, API key, bearer token, or other credentials and tell Composio to use them for a toolkit.
11
12
This page covers when to use each, how to create a custom auth config, and how to wire it into a session.
13
14
## When to use Composio managed apps
15
16
-Managed apps are the default. Every toolkit that supports OAuth has a Composio managed app ready to go. Use them when:
16
+Managed apps are the default when they are available. Use them when:
17
18
- **You're building and iterating.** No OAuth app registration, no credentials to manage. Create a session and start testing immediately.
19
- **Default scopes cover your needs.** Composio requests sensible defaults for each toolkit.
@@ -32,7 +32,7 @@ Bring your own credentials when any of these apply:
32
33
## Create a custom auth config
34
35
-To check whether a toolkit already has a Composio managed app, see the [managed auth toolkit list](/toolkits/managed-auth). You can still create a custom auth config for branding, scopes, rate limits, polling intervals, or custom instances.
35
+To check whether Composio provides the OAuth app for a toolkit, see [Managed OAuth apps](/toolkits/managed-auth). You can still create a custom auth config for branding, scopes, rate limits, polling intervals, or custom instances.
36
37
The steps below use the dashboard. To create auth configs in code instead, for example one per customer, see [Programmatic auth configs](/docs/authentication/programmatic-auth-configs).
38
@@ -138,7 +138,7 @@ const session = await composio.create("user_123", {
138
139
### Toolkits without managed auth
140
141
-Some toolkits don't have Composio managed auth. For these, the setup is the same as above, except the provider may ask for API keys or instance details instead of OAuth credentials. Browse the full list on the [managed auth page](/toolkits/managed-auth) or check individual toolkit pages on the [toolkits page](/toolkits).
141
+Some OAuth toolkits do not have a Composio-managed OAuth app. Check [Managed OAuth apps](/toolkits/managed-auth) to find them. For API keys, instance details, and other authentication methods, check the individual pages in the [toolkit catalog](/toolkits).
142
143
## Next
144
docs/content/toolkits/managed-auth.mdx
+22
-38
@@ -1,61 +1,45 @@
1
---
2
-title: Managed Auth
3
-description: Find out which toolkits work with Composio managed authentication and when you need your own credentials
4
-keywords: [managed auth, oauth, auth config, own developer credentials, toolkit list]
2
+title: Managed OAuth apps
3
+description: Check whether Composio provides the OAuth app for a toolkit or you need to register your own
4
+keywords: [managed OAuth, OAuth app, auth config, client credentials, toolkit list]
5
---
6
7
-Managed auth means Composio registers and maintains the OAuth app for a toolkit, so your users can connect their accounts with no OAuth credentials for you to set up. Most popular toolkits (GitHub, Gmail, Slack, and many more) ship with managed auth and work the moment you create a session.
7
+Composio can provide the OAuth app that your users authorize when they connect a toolkit. You do not need to register an OAuth app or supply its client ID and client secret.
8
9
-When a tool needs an account, the [`COMPOSIO_MANAGE_CONNECTIONS`](/toolkits/meta-tools/manage_connections) meta tool returns a secure [Connect Link](/docs/tools-direct/authenticating-tools#hosted-authentication-connect-link). The user signs in there, and Composio stores and refreshes their tokens. You write no auth code. See [Authentication](/docs/authentication) for the full flow.
9
+Your users still authorize their accounts through a [Connect Link](/docs/tools-direct/authenticating-tools#hosted-authentication-connect-link). Composio stores and refreshes the resulting tokens. See [Authentication](/docs/authentication) for the full connection flow.
10
11
-## When you don't need to do anything
11
+This page covers only toolkits that support OAuth. It does not list toolkits that use only API keys, bearer tokens, Basic auth, or no authentication.
12
13
-For any toolkit with managed auth, you don't register an OAuth app, manage credentials, or handle token refresh. Create a session and start calling tools:
13
+## When Composio provides the OAuth app
14
15
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
16
-<Tab value="Python">
17
-```python
18
-from composio import Composio
15
+For a toolkit with managed OAuth, Composio maintains the OAuth app registration, client credentials, and redirect URI. Your users sign in to the provider and approve the requested permissions.
16
20
-composio = Composio()
21
-session = composio.create(user_id="user_123")
22
-# Tools that need an account return a Connect Link automatically
23
-```
24
-</Tab>
25
-<Tab value="TypeScript">
26
-```typescript
27
-import { Composio } from '@composio/core';
28
-
29
-const composio = new Composio();
30
-const session = await composio.create("user_123");
31
-// Tools that need an account return a Connect Link automatically
32
-```
33
-</Tab>
34
-</Tabs>
17
+## When you provide the OAuth app
18
+
19
+Register your own OAuth app when a toolkit does not have managed OAuth. Then create a custom auth config with the app's client ID and client secret.
20
36
-## When you need your own credentials
21
+You can also provide your own OAuth app to show your app name on the consent screen, request custom scopes, or use a separate rate-limit quota.
22
38
-You need a custom auth config when you want to:
23
+See [Managed vs custom auth](/docs/authentication/custom-app-vs-managed-app) for setup steps and trade-offs.
24
40
-- **Bring your own OAuth app**, so users see your app name on the consent screen instead of "Composio."
41
-- **Request specific scopes** beyond Composio's defaults.
42
-- **Use a toolkit without managed auth**, where you supply an API key, bearer token, or instance details.
25
+## Find an OAuth toolkit
26
44
-See [Managed vs custom auth](/docs/authentication/custom-app-vs-managed-app) for the full decision guide and setup steps. You can mix the two: use your own credentials for some toolkits and managed auth for the rest.
27
+Search for a toolkit to check whether Composio provides a managed OAuth app.
28
46
-## Find a toolkit
29
+- **Composio-managed OAuth available** means that you can use Composio's OAuth app.
30
+- **Bring your own OAuth app** means that you must register an OAuth app with the provider and create a custom auth config.
31
48
-Search the list below to check whether a toolkit has managed auth. Toolkits under **Composio Managed App Available** work out of the box. Toolkits under **Requires your own credentials** need a custom auth config.
32
+Some toolkits support more than one authentication method. A toolkit appears under **Composio-managed OAuth available** when Composio manages at least one OAuth method. Open the toolkit page to check each method.
33
34
<ManagedAuthList />
35
52
-## Check programmatically
36
+## Check with the API
37
54
-To check a single toolkit from a script, call the toolkit endpoint and read its managed auth schemes:
38
+Call the toolkit endpoint and read `composio_managed_auth_schemes`:
39
40
```bash
57
-curl 'https://backend.composio.dev/api/v3.1/toolkits/posthog' \
41
+curl 'https://backend.composio.dev/api/v3.1/toolkits/gmail' \
42
-H 'x-api-key: YOUR_API_KEY'
43
```
44
61
-A toolkit that lists managed auth schemes in the response has managed auth. An empty list means you need to supply your own credentials.
45
+If `composio_managed_auth_schemes` contains the toolkit's OAuth method, Composio provides the OAuth app. If the field does not contain that method, register your own OAuth app and supply its client ID and client secret.