@devries-cameron20 / composio Mirror · read-only / commits / a0dbc6fba
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, 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