> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Apr 9, 2026

> Latest updates and announcements

## Multi-Account Mode & Connection Aliases

This release adds two features for managing multiple accounts per toolkit.

## Multi-account mode

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.

```typescript theme={null}
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: 'your_api_key' });
const session = await composio.create('user_123', {
  toolkits: ['gmail'],
  multiAccount: {
    enable: true,
    maxAccountsPerToolkit: 3,
  },
});
```

By default, multi-account mode is disabled and each session uses one account per toolkit.

## Connection aliases

Connected accounts can now have human-readable aliases (e.g., `"work-gmail"`, `"personal-github"`). Aliases can be set during connection or updated after.

```typescript theme={null}
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: 'your_api_key' });
const session = await composio.create('user_123');
// Set alias during connection
await session.authorize('gmail', { alias: 'work-gmail' });

// Update alias on an existing account
await composio.connectedAccounts.update('ca_abc123', { alias: 'work-gmail' });
```

Aliases must be unique per user and toolkit within a project.

See the [multi-account guide](https://composio-preview.mintlify.site/docs/authentication/managing-multiple-connected-accounts.md) for full details.
