Canonical: https://composio.dev/glossary/connected-account
Markdown: https://composio.dev/glossary/connected-account.md

# Connected account

A connected account is a stored set of provider credentials linked to a user and toolkit, created when the user authenticates with that service.

The credentials can be OAuth tokens or an API key. Composio uses the selected connected account to authenticate tool execution and refreshes OAuth tokens when the provider supports refresh.

One user can connect more than one account for the same toolkit, such as two GitHub accounts. Your application must select the intended connection and keep user identities separate. An auth config describes how to connect; a connected account records a particular connection.

## Related terms

- [Auth config](https://composio.dev/glossary/auth-config)

- [Session](https://composio.dev/glossary/session)

- [Token custody](https://composio.dev/glossary/token-custody)

## Sources and implementation

- Technical reference: [Technical glossary: connected account](https://docs.composio.dev/reference/glossary#connected-account)

- Implementation guide: [Managing multiple connected accounts](https://docs.composio.dev/docs/authentication/managing-multiple-connected-accounts)

- On this site: [Authentication guides](https://composio.dev/auth)

[All glossary terms](https://composio.dev/glossary)

Reviewed: 2026-10-29
Next review: 2027-01-29
Owner: Brendan O'Leary / Developer Marketing