@devries-cameron20 / composio Mirror · read-only
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, 06:00 UTC

next
mdx 48 lines 1.56 KB
Raw
1 ---
2 title: "Multi-Account Mode & Connection Aliases"
3 description: "Enable multiple connected accounts per toolkit and label them with human-readable aliases"
4 date: "2026-04-09"
5 ---
6
7 This release adds two features for managing multiple accounts per toolkit.
8
9 ## Multi-account mode
10
11 Sessions now support a `multiAccount` config that lets users connect and use multiple accounts for the same toolkit (e.g., work and personal Gmail) within a single session.
12
13 ```typescript
14 // @noErrors
15 import { Composio } from '@composio/core';
16 const composio = new Composio({ apiKey: 'your_api_key' });
17 // ---cut---
18 const session = await composio.create('user_123', {
19 toolkits: ['gmail'],
20 multiAccount: {
21 enable: true,
22 maxAccountsPerToolkit: 3,
23 },
24 });
25 ```
26
27 By default, multi-account mode is disabled and each session uses one account per toolkit.
28
29 ## Connection aliases
30
31 Connected accounts can now have human-readable aliases (e.g., `"work-gmail"`, `"personal-github"`). Aliases can be set during connection or updated after.
32
33 ```typescript
34 // @noErrors
35 import { Composio } from '@composio/core';
36 const composio = new Composio({ apiKey: 'your_api_key' });
37 const session = await composio.create('user_123');
38 // ---cut---
39 // Set alias during connection
40 await session.authorize('gmail', { alias: 'work-gmail' });
41
42 // Update alias on an existing account
43 await composio.connectedAccounts.update('ca_abc123', { alias: 'work-gmail' });
44 ```
45
46 Aliases must be unique per user and toolkit within a project.
47
48 See the [multi-account guide](/docs/authentication/managing-multiple-connected-accounts) for full details.