@devries-cameron20 / composio Mirror · read-only / commits / 5608d89cb
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, 14:45 UTC

docs(auth): point custom OAuth callback URL to v1

Consumer product and the backend-provided default redirect URI use the v1 callback (api/v1/auth-apps/add), but the developer docs instructed the v3.1 URL (api/v3.1/toolkits/auth/callback). Users copied the wrong URL into their OAuth app allow lists. Align all instructional docs + the Python example with v1. The migration guide (migration-guide/new-sdk.mdx) is left unchanged: it documents the v1->v3 history and flipping it would make it contradictory. Fixes UXE-261. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Sarah Simionescu committed Aug 21, 2026 at 22:53 UTC 5608d89cbc624f1272ba1543a1b40842335d3513
5 files changed +10 -10
docs/content/docs/auth-configuration/custom-auth-configs.mdx
+1 -1
@@ -79,7 +79,7 @@ Examples for Google and GitHub:
79 When creating your OAuth app, make sure to configure the Authorized Redirect URI to point to the Composio callback URL below:
80
81 ```
82 -https://backend.composio.dev/api/v3.1/toolkits/auth/callback
82 +https://backend.composio.dev/api/v1/auth-apps/add
83 ```
84 </Step>
85
docs/content/docs/auth-configuration/white-labeling.mdx
+3 -3
@@ -78,7 +78,7 @@ Only white-label toolkits where users see a consent screen (Google, GitHub, Slac
78 Register a new OAuth app with the toolkit. Set the callback URL to:
79
80 ```
81 -https://backend.composio.dev/api/v3.1/toolkits/auth/callback
81 +https://backend.composio.dev/api/v1/auth-apps/add
82 ```
83
84 You'll get a **Client ID** and **Client Secret**.
@@ -236,7 +236,7 @@ app = FastAPI()
236
237 @app.get("/api/composio-redirect")
238 def composio_redirect(request: Request):
239 - composio_url = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback"
239 + composio_url = "https://backend.composio.dev/api/v1/auth-apps/add"
240 return RedirectResponse(url=f"{composio_url}?{request.url.query}")
241 ```
242 </Tab>
@@ -246,7 +246,7 @@ def composio_redirect(request: Request):
246 import type { NextApiRequest, NextApiResponse } from "next";
247
248 export default function handler(req: NextApiRequest, res: NextApiResponse) {
249 - const composioUrl = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback";
249 + const composioUrl = "https://backend.composio.dev/api/v1/auth-apps/add";
250 const params = new URLSearchParams(req.query as Record<string, string>);
251 res.redirect(302, `${composioUrl}?${params.toString()}`);
252 }
docs/content/docs/authentication/programmatic-auth-configs.mdx
+3 -3
@@ -48,7 +48,7 @@ console.log(authConfig.id); // ac_xxxxxxxx
48 Bring your own OAuth app to show your branding on consent screens, request custom scopes, or get a dedicated rate-limit quota. Register the app in the provider's developer portal, set its authorized redirect URI to Composio's callback, then pass the client ID and secret.
49
50 ```
51 -https://backend.composio.dev/api/v3.1/toolkits/auth/callback
51 +https://backend.composio.dev/api/v1/auth-apps/add
52 ```
53
54 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
@@ -68,7 +68,7 @@ auth_config = composio.auth_configs.create(
68 "credentials": {
69 "client_id": os.environ["NOTION_CLIENT_ID"],
70 "client_secret": os.environ["NOTION_CLIENT_SECRET"],
71 - "oauth_redirect_uri": "https://backend.composio.dev/api/v3.1/toolkits/auth/callback",
71 + "oauth_redirect_uri": "https://backend.composio.dev/api/v1/auth-apps/add",
72 },
73 },
74 )
@@ -87,7 +87,7 @@ const authConfig = await composio.authConfigs.create('notion', {
87 credentials: {
88 client_id: process.env.NOTION_CLIENT_ID!,
89 client_secret: process.env.NOTION_CLIENT_SECRET!,
90 - oauth_redirect_uri: 'https://backend.composio.dev/api/v3.1/toolkits/auth/callback',
90 + oauth_redirect_uri: 'https://backend.composio.dev/api/v1/auth-apps/add',
91 },
92 });
93 ```
docs/content/docs/authentication/white-labeling-authentication.mdx
+2 -2
@@ -107,7 +107,7 @@ app = FastAPI()
107
108 @app.get("/api/composio-redirect")
109 def composio_redirect(request: Request):
110 - composio_url = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback"
110 + composio_url = "https://backend.composio.dev/api/v1/auth-apps/add"
111 return RedirectResponse(url=f"{composio_url}?{request.url.query}")
112 ```
113 </Tab>
@@ -117,7 +117,7 @@ def composio_redirect(request: Request):
117 import type { NextApiRequest, NextApiResponse } from "next";
118
119 export default function handler(req: NextApiRequest, res: NextApiResponse) {
120 - const composioUrl = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback";
120 + const composioUrl = "https://backend.composio.dev/api/v1/auth-apps/add";
121 const params = new URLSearchParams(req.query as Record<string, string>);
122 res.redirect(302, `${composioUrl}?${params.toString()}`);
123 }
python/examples/auth_configs.py
+1 -1
@@ -25,7 +25,7 @@ auth_config = composio.auth_configs.create( # type: ignore[call-overload] # cr
25 "credentials": {
26 "client_id": "1234567890",
27 "client_secret": "1234567890",
28 - "oauth_redirect_uri": "https://backend.composio.dev/api/v3/toolkits/auth/callback",
28 + "oauth_redirect_uri": "https://backend.composio.dev/api/v1/auth-apps/add",
29 },
30 },
31 )