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): 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
)