@devries-cameron20 / composio-1 / commits / 1e1530d66
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.

docs: clarify bearer token self-managed OAuth responsibility

Explain that when importing bearer tokens, Composio does not handle OAuth refresh — users must refresh tokens themselves and update via the PATCH method. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

dhawal committed Apr 11, 2026 at 05:53 UTC 1e1530d66c83dbcbbe909b464ce4b73c3dc00035
1 file changed +4 -2
docs/content/docs/importing-existing-connections.mdx
+4 -2
@@ -74,9 +74,11 @@ console.log('Connected:', connection.id);
74
75 ## Bearer tokens
76
77 -If you already have an access token for a service (e.g., from an OAuth flow you manage), you can pass it directly to Composio as a bearer token. This works with **all toolkits that support OAuth2 or S2S auth** — Gmail, GitHub, Slack, Google Docs, and more. Any additional parameters the toolkit supports (e.g., `subdomain`, `base_url`) work the same way.
77 +If you manage your own OAuth flow and already have an access token for a service, you can pass it directly to Composio as a bearer token instead of setting up OAuth through Composio. This works with **all toolkits that support OAuth2 or S2S auth** — Gmail, GitHub, Slack, Google Docs, and more. Any additional parameters the toolkit supports (e.g., `subdomain`, `base_url`) work the same way.
78
79 -After [creating an auth config](/docs/auth-configuration/programmatic-auth-configs) with `authScheme: "BEARER_TOKEN"`, use the snippet below to create a connected account. Since access tokens typically expire, use the [PATCH endpoint](#updating-credentials) to push a refreshed token whenever it changes on your end.
79 +**Important:** When you import a bearer token this way, Composio will **not** handle OAuth token refresh for you. You are responsible for refreshing the token on your end and updating it in Composio via the [PATCH method](#updating-credentials) whenever it changes.
80 +
81 +After [creating an auth config](/docs/auth-configuration/programmatic-auth-configs) with `authScheme: "BEARER_TOKEN"`, use the snippet below to create a connected account:
82
83 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
84 <Tab value="Python">