Skip to content

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

dhawal1e1530d66c83
diff --git a/docs/content/docs/importing-existing-connections.mdx b/docs/content/docs/importing-existing-connections.mdx
index c4381da4d..628af35c8 100644
--- a/docs/content/docs/importing-existing-connections.mdx
+++ b/docs/content/docs/importing-existing-connections.mdx
@@ -74,9 +74,11 @@ console.log('Connected:', connection.id);
## Bearer tokens
-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.
+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.
-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.
+**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.
+
+After [creating an auth config](/docs/auth-configuration/programmatic-auth-configs) with `authScheme: "BEARER_TOKEN"`, use the snippet below to create a connected account:
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
<Tab value="Python">