Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Add composio auth link into changelogs (#1933)
Musthaq Ahamad committed
Sep 15, 2025 at 15:35 UTC
91e0a4a59f4edb7d5a0a5593174a6669b40bc913
3 files changed
+87
-3
fern/docs.yml
+1
-1
@@ -92,7 +92,7 @@ tabs:
92
changelog:
93
display-name: Changelog
94
icon: history
95
- changelog: ./pages/changelog
95
+ changelog: ./pages/src/changelog
96
navigation:
97
- tab: docs
98
layout:
fern/pages/src/changelog/08-15-25.md
new
+86
@@ -0,0 +1,86 @@
1
+# Introducing Composio Auth Links
2
+
3
+Composio Auth Links provide a **hosted authentication solution** that eliminates the need for developers to build custom authentication forms. Instead of manually rendering OAuth consent screens, API key input forms, or custom authentication fields, developers can simply redirect users to a Composio-hosted URL that handles the entire authentication process automatically.
4
+
5
+## Why Use Auth Links?
6
+
7
+- **Zero UI Development**: No need to build forms for OAuth, API keys, or custom fields like subdomains
8
+- **Universal Authentication**: Works seamlessly across all supported third-party services
9
+- **Reduced Complexity**: Replace complex OAuth flows with a simple redirect
10
+- **Better UX**: Professional, consistent authentication experience for end users
11
+- **Faster Integration**: Get authentication working in minutes, not hours
12
+
13
+---
14
+
15
+## Python SDK (v0.8.11)
16
+
17
+**Added**
18
+
19
+- **Composio Connect Link Support**: New `link()` method for creating external authentication links
20
+ - Added `link()` method to `ConnectedAccounts` class for generating user authentication links
21
+ - Support for callback URL redirection after authentication
22
+ - Enhanced user experience with external link-based authentication flow
23
+ - **No manual form rendering required** - Composio handles all authentication UI
24
+
25
+**Examples:**
26
+
27
+```python
28
+# Basic usage - create a connection request
29
+connection_request = composio.connected_accounts.link('user_123', 'auth_config_123')
30
+redirect_url = connection_request.redirect_url
31
+print(f"Visit: {redirect_url} to authenticate your account")
32
+
33
+# Wait for the connection to be established
34
+connected_account = connection_request.wait_for_connection()
35
+
36
+# With callback URL
37
+connection_request = composio.connected_accounts.link(
38
+ 'user_123',
39
+ 'auth_config_123',
40
+ callback_url='<https://your-app.com/callback>'
41
+)
42
+
43
+```
44
+
45
+## TypeScript SDK (v0.1.51)
46
+
47
+**Added**
48
+
49
+- **Composio Connect Links**: Added support for composio connect links
50
+ - New `link()` method in `ConnectedAccounts` class for generating authentication URLs
51
+ - Support for callback URL redirection with `CreateConnectedAccountLinkOptions`
52
+ - Comprehensive TypeScript types and validation for link creation options
53
+ - **Eliminates need for custom authentication forms** - just redirect users to the link
54
+
55
+**Examples:**
56
+
57
+```tsx
58
+// Basic usage - create a connection request
59
+const connectionRequest = await composio.connectedAccounts.link('user_123', 'auth_config_123');
60
+const redirectUrl = connectionRequest.redirectUrl;
61
+console.log(`Visit: ${redirectUrl} to authenticate your account`);
62
+
63
+// Wait for the connection to be established
64
+const connectedAccount = await connectionRequest.waitForConnection();
65
+
66
+// With callback URL
67
+const connectionRequest = await composio.connectedAccounts.link('user_123', 'auth_config_123', {
68
+ callbackUrl: '<https://your-app.com/callback>'
69
+});
70
+
71
+```
72
+
73
+## Key Benefits
74
+
75
+- **No Form Building**: Composio handles OAuth consent, API key collection, and custom field inputs
76
+- **Hosted Authentication Flow**: Professional UI that works across all supported services
77
+- **Callback URL Support**: Control where users return after successful authentication
78
+- **Connection Waiting**: Built-in polling to detect when authentication completes
79
+- **Cross-Platform Consistency**: Identical developer experience across Python and TypeScript
80
+
81
+## Customisation
82
+
83
+You can customise the app logo and name showed in the authentication page via the dashboard. Head over your project via `platform.composio.dev` and choose Settings → Auth Links to upload a new logo and change the name.
84
+
85
+## Migration Note
86
+This feature replaces manual authentication form development with a simple redirect-based approach, significantly reducing integration time and complexity while providing a better user experience. Auth links are drop in replacement for `composio.connectedAccounts.initate`, you can safely swap this to `composio.connectedAccounts.link`
\ No newline at end of file
fern/pages/src/changelog/2025-06-01.md
deleted
-2
@@ -1,2 +0,0 @@
1
-## Docs
2
-🚧 Work in progress!
\ No newline at end of file