Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
add
Sushmithamalleshddb52c7bdd07
diff --git a/fern/docs.yml b/fern/docs.ymlindex 9090aedf2..7ae4210e2 100644--- a/fern/docs.yml+++ b/fern/docs.yml@@ -314,6 +314,9 @@ navigation:- page: Manually Authenticating Userspath: pages/dist/tool-router/manually-authenticating-users.mdxslug: 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 Authenticationpath: pages/dist/tool-router/white-labeling-authentication.mdxslug: white-labeling-authenticationdiff --git a/fern/pages/src/tool-router/managing-multiple-accounts.mdx b/fern/pages/src/tool-router/managing-multiple-accounts.mdxnew file mode 100644index 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.mdxindex 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 usedorder_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)``````typescriptconst 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 remaA 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.pyindex 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 Composiofrom 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.tsindex 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.",