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, 12:15 UTC
docs: clarify OAuth callback URL matching
Brendan O'Leary committed
Sep 15, 2026 at 15:06 UTC
a0dbc6fbae62c8329b466cf62c95cd74eb49e339
3 files changed
+9
-3
docs/content/docs/auth-configuration/custom-auth-configs.mdx
+6
-1
@@ -81,6 +81,10 @@ When creating your OAuth app, make sure to configure the Authorized Redirect URI
81
```
82
https://backend.composio.dev/api/v3/toolkits/auth/callback
83
```
84
+
85
+<Callout type="info" title="Match the redirect URI">
86
+The redirect URI in your OAuth app must exactly match `oauth_redirect_uri` in your Composio auth config. Some toolkit defaults still use `https://backend.composio.dev/api/v1/auth-apps/add`, which remains supported. To use the URL above, set it explicitly in both places to avoid `redirect_uri_mismatch` errors.
87
+</Callout>
88
</Step>
89
90
<Step>
@@ -91,7 +95,8 @@ Once you have the OAuth credentials, you can add them to the auth config in the
95
1. Select the OAuth2 scheme.
96
2. Toggle on **Use your own developer credentials**.
97
3. Enter the OAuth client ID and client secret for your developer app.
94
-4. Click Create!
98
+4. Set **Redirect URI** to the URL registered in your OAuth app.
99
+5. Click Create!
100
101
<Figure src="/images/integration-step-3-0.png" alt="Auth Config Settings" caption="Auth Config Settings" size="sm" />
102
</Step>
docs/content/docs/auth-configuration/white-labeling.mdx
+2
-1
@@ -96,7 +96,8 @@ In the [Composio dashboard](https://dashboard.composio.dev?utm_source=docs&utm_m
96
3. Choose **OAuth2** scheme
97
4. Toggle on **Use your own developer credentials**
98
5. Enter your **Client ID** and **Client Secret**
99
-6. Click **Create**
99
+6. Set **Redirect URI** to the same callback URL you registered with the provider
100
+7. Click **Create**
101
102
Copy the auth config ID (e.g., `ac_1234abcd`).
103
docs/content/docs/authentication/programmatic-auth-configs.mdx
+1
-1
@@ -95,7 +95,7 @@ const authConfig = await composio.authConfigs.create('notion', {
95
</Tabs>
96
97
<Callout type="info">
98
-Omit `oauth_redirect_uri` to use Composio's default callback. Set it only when you [route the callback through your own domain](/docs/authentication/white-labeling-authentication#routing-the-callback-through-your-domain).
98
+Set `oauth_redirect_uri` to the exact URL registered in your provider's OAuth app. Some toolkit defaults still use the supported legacy endpoint `https://backend.composio.dev/api/v1/auth-apps/add`. If you omit `oauth_redirect_uri`, register the toolkit's default URL with your provider. When you [route the callback through your own domain](/docs/authentication/white-labeling-authentication#routing-the-callback-through-your-domain), set your custom URL in both places.
99
</Callout>
100
101
## Other auth types