Skip to content

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

Sushmithamalleshddb52c7bdd07
diff --git a/fern/docs.yml b/fern/docs.yml
index 9090aedf2..7ae4210e2 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -314,6 +314,9 @@ navigation:
- page: Manually Authenticating Users
path: pages/dist/tool-router/manually-authenticating-users.mdx
slug: manually-authenticating-users
+ - page: Managing Multiple Accounts for a User
+ path: pages/dist/tool-router/managing-multiple-accounts.mdx
+ slug: managing-multiple-accounts
- page: White-labeling Authentication
path: pages/dist/tool-router/white-labeling-authentication.mdx
slug: white-labeling-authentication
diff --git a/fern/pages/src/tool-router/managing-multiple-accounts.mdx b/fern/pages/src/tool-router/managing-multiple-accounts.mdx
new file mode 100644
index 000000000..9266c36ff
--- /dev/null
+++ b/fern/pages/src/tool-router/managing-multiple-accounts.mdx
@@ -0,0 +1,53 @@
+---
+title: Managing multiple accounts for a user
+image: "https://og.composio.dev/api/og?title=Managing%20Multiple%20Accounts"
+description: "Handle users with multiple accounts for the same toolkit"
+keywords: "tool router, multiple accounts, connected accounts, account selection"
+---
+
+Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail). Tool Router uses the most recently connected account by default.
+
+## Selecting a specific account
+
+To use a specific account, pass it in the session config:
+
+<CodeGroup>
+```python
+session = composio.create(
+ user_id=user_id,
+ connected_accounts={
+ "gmail": "ca_specific_account_id",
+ },
+)
+```
+```typescript
+const session = await composio.create(userId, {
+ connectedAccounts: {
+ gmail: "ca_specific_account_id",
+ },
+});
+```
+</CodeGroup>
+
+## Listing connected accounts
+
+Use `session.toolkits()` to see all connected accounts for a user:
+
+<CodeGroup>
+```python
+toolkits = session.toolkits()
+
+for toolkit in toolkits:
+ if toolkit.connected_account:
+ print(f"{toolkit.name}: {toolkit.connected_account.id}")
+```
+```typescript
+const toolkits = await session.toolkits();
+
+for (const toolkit of toolkits) {
+ if (toolkit.connectedAccount) {
+ console.log(`${toolkit.name}: ${toolkit.connectedAccount.id}`);
+ }
+}
+```
+</CodeGroup>
diff --git a/fern/pages/src/tool-router/manually-authenticating-users.mdx b/fern/pages/src/tool-router/manually-authenticating-users.mdx
index fd001c966..535aa0b13 100644
--- a/fern/pages/src/tool-router/manually-authenticating-users.mdx
+++ b/fern/pages/src/tool-router/manually-authenticating-users.mdx
@@ -15,8 +15,8 @@ Disable the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool so the agent doesn't prompt
<CodeGroup>
```python
-session = await composio.create(
- user="user_123",
+session = composio.create(
+ user_id="user_123",
manage_connections=False,
)
```
@@ -33,7 +33,7 @@ Use `session.toolkits()` to see which apps the user has connected:
<CodeGroup>
```python
-toolkits = await session.toolkits()
+toolkits = session.toolkits()
for toolkit in toolkits:
status = toolkit.connected_account.status if toolkit.connected_account else "Not connected"
@@ -59,7 +59,7 @@ Use filters to show relevant toolkits in your UI:
<CodeGroup>
```python
-toolkits = await session.toolkits(
+toolkits = session.toolkits(
order_by="popularity", # Sort by most used
order_direction="desc",
category="developer-tools", # Filter by category
@@ -82,7 +82,7 @@ Use `session.authorize()` to generate a [Connect Link](/docs/authenticating-tool
<CodeGroup>
```python
-connection_request = await session.authorize(
+connection_request = session.authorize(
"gmail",
callback_url="https://yourapp.com/callback"
)
@@ -92,7 +92,7 @@ print(connection_request.redirect_url)
```
```typescript
const connectionRequest = await session.authorize("gmail", {
- callbackUrl: "https://yourapp.com/callback",
+ callbackUri: "https://yourapp.com/callback",
});
console.log(connectionRequest.redirectUrl);
@@ -108,7 +108,7 @@ Use `waitForConnection()` to poll until the user completes authentication:
<CodeGroup>
```python
-connected_account = await connection_request.wait_for_connection(60000)
+connected_account = connection_request.wait_for_connection(60000)
print(f"Connected: {connected_account.id}")
```
```typescript
@@ -130,129 +130,6 @@ If the user closes the Connect Link without completing auth, the connection rema
A common pattern is to verify all required connections before starting the agent. For example, a personal assistant might need Gmail, Calendar, Linear, and Slack:
<CodeGroup>
-```python
-from composio import Composio
-from agents import Agent, Runner, HostedMCPTool
-
-composio = Composio()
-
-required_toolkits = ["gmail", "googlecalendar", "linear", "slack"]
-
-session = composio.create(
- user_id=user_id,
- manage_connections=False,
-)
-
-toolkits = session.toolkits()
-
-def is_connected(slug):
- toolkit = next((t for t in toolkits if t.slug == slug), None)
- return toolkit and toolkit.connected_account
-
-pending = [slug for slug in required_toolkits if not is_connected(slug)]
-
-if pending:
- for slug in pending:
- connection_request = session.authorize(
- slug,
- callback_url="https://yourapp.com/onboarding"
- )
- print(f"Connect {slug}: {connection_request.redirect_url}")
- connection_request.wait_for_connection()
-
-agent = Agent(
- name="Personal Assistant",
- instructions="You are a helpful personal assistant.",
- tools=[
- HostedMCPTool(
- tool_config={
- "type": "mcp",
- "server_label": "composio",
- "server_url": session.mcp.url,
- "require_approval": "never",
- }
- )
- ],
-)
-
-result = Runner.run_sync(agent, "Summarize my emails from today")
-print(result.final_output)
-```
-```typescript
-import { Composio } from "@composio/core";
-import { Agent, run, hostedMcpTool } from "@openai/agents";
-
-const composio = new Composio();
-
-const requiredToolkits = ["gmail", "googlecalendar", "linear", "slack"];
-
-const session = await composio.create(userId, {
- manageConnections: false,
-});
-
-const toolkits = await session.toolkits();
-
-const pending = requiredToolkits.filter((slug) => {
- const toolkit = toolkits.find((t) => t.slug === slug);
- return !toolkit?.connectedAccount;
-});
-
-for (const slug of pending) {
- const connectionRequest = await session.authorize(slug, {
- callbackUrl: "https://yourapp.com/onboarding",
- });
- console.log(`Connect ${slug}: ${connectionRequest.redirectUrl}`);
- await connectionRequest.waitForConnection();
-}
-
-const agent = new Agent({
- name: "Personal Assistant",
- instructions: "You are a helpful personal assistant.",
- tools: [
- hostedMcpTool({
- serverLabel: "composio",
- serverUrl: session.mcp.url,
- }),
- ],
-});
-
-const result = await run(agent, "Summarize my emails from today");
-console.log(result.finalOutput);
-```
+<SnippetCode src="fern/snippets/tool-router/python/manual-auth.py" title="Python" />
+<SnippetCode src="fern/snippets/tool-router/typescript/manual-auth.ts" title="TypeScript" />
</CodeGroup>
-
-## Multiple accounts
-
-Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail). Tool Router uses the most recently connected account by default.
-
-To use a specific account, pass it in the session config:
-
-<CodeGroup>
-```python
-session = await composio.create(
- user=user_id,
- connected_accounts={
- "gmail": "ca_specific_account_id",
- },
-)
-```
-```typescript
-const session = await composio.create(userId, {
- connectedAccounts: {
- gmail: "ca_specific_account_id",
- },
-});
-```
-</CodeGroup>
-
-## Full example
-
-<CodeGroup>
-<CodeGroupItem title="Python">
-<SnippetCode src="fern/snippets/tool-router/python/manual-auth.py" />
-</CodeGroupItem>
-<CodeGroupItem title="TypeScript">
-<SnippetCode src="fern/snippets/tool-router/typescript/manual-auth.ts" />
-</CodeGroupItem>
-</CodeGroup>
-
diff --git a/fern/snippets/tool-router/python/manual-auth.py b/fern/snippets/tool-router/python/manual-auth.py
index fdcdc600a..c09b61b60 100644
--- a/fern/snippets/tool-router/python/manual-auth.py
+++ b/fern/snippets/tool-router/python/manual-auth.py
@@ -1,9 +1,8 @@
from composio import Composio
from agents import Agent, Runner, HostedMCPTool
-composio = Composio(api_key="your-composio-api-key")
+composio = Composio()
-user_id = "pg-user-550e8400-e29b-41d4"
required_toolkits = ["gmail", "googlecalendar", "linear", "slack"]
session = composio.create(
@@ -20,18 +19,13 @@ def is_connected(slug):
pending = [slug for slug in required_toolkits if not is_connected(slug)]
if pending:
- print("Connect these apps to continue:")
-
for slug in pending:
connection_request = session.authorize(
slug,
callback_url="https://yourapp.com/onboarding"
)
- print(f" {slug}: {connection_request.redirect_url}")
- connection_request.wait_for_connection(60000)
- print(f" {slug} connected")
-
-print("\nAll apps connected. Starting assistant...")
+ print(f"Connect {slug}: {connection_request.redirect_url}")
+ connection_request.wait_for_connection()
agent = Agent(
name="Personal Assistant",
diff --git a/fern/snippets/tool-router/typescript/manual-auth.ts b/fern/snippets/tool-router/typescript/manual-auth.ts
index 1c1cb754f..b37b41161 100644
--- a/fern/snippets/tool-router/typescript/manual-auth.ts
+++ b/fern/snippets/tool-router/typescript/manual-auth.ts
@@ -1,9 +1,8 @@
import { Composio } from "@composio/core";
import { Agent, run, hostedMcpTool } from "@openai/agents";
-const composio = new Composio({ apiKey: "your-composio-api-key" });
+const composio = new Composio();
-const userId = "pg-user-550e8400-e29b-41d4";
const requiredToolkits = ["gmail", "googlecalendar", "linear", "slack"];
const session = await composio.create(userId, {
@@ -17,21 +16,14 @@ const pending = requiredToolkits.filter((slug) => {
return !toolkit?.connectedAccount;
});
-if (pending.length > 0) {
- console.log("Connect these apps to continue:");
-
- for (const slug of pending) {
- const connectionRequest = await session.authorize(slug, {
- callbackUrl: "https://yourapp.com/onboarding",
- });
- console.log(` ${slug}: ${connectionRequest.redirectUrl}`);
- await connectionRequest.waitForConnection(60000);
- console.log(` ${slug} connected`);
- }
+for (const slug of pending) {
+ const connectionRequest = await session.authorize(slug, {
+ callbackUri: "https://yourapp.com/onboarding",
+ });
+ console.log(`Connect ${slug}: ${connectionRequest.redirectUrl}`);
+ await connectionRequest.waitForConnection();
}
-console.log("\nAll apps connected. Starting assistant...");
-
const agent = new Agent({
name: "Personal Assistant",
instructions: "You are a helpful personal assistant.",