Bearer Token Connections & Credential Patching
Two features for teams managing their own authentication credentials.Bearer Token for OAuth Toolkits
All OAuth2 toolkits (Gmail, GitHub, Slack, Google Docs, and more) now supportBEARER_TOKEN as an auth scheme. Import your own access tokens directly without setting up an OAuth app.
BEARER_TOKEN is injected as an alternative scheme alongside OAuth2, so existing OAuth connections are unaffected.
How to use
- Create a custom auth config with
authScheme: "BEARER_TOKEN"for the toolkit - Create a connected account with your access token
- Pass the auth config or connection ID to
composio.create()for use with Tool Router
Creating bearer token auth configs is currently available only via API and SDK — not yet supported in the dashboard UI.
Credential Patching
NewPATCH /api/v3/connected_accounts/{nanoid} endpoint and SDK method — update credentials and alias on existing connections without recreating them.
- Keep access tokens updated — call PATCH whenever you refresh the token on your end (e.g., after an OAuth refresh flow)
- Partial updates — omitted fields are preserved, fields set to
nullare removed - Supported schemes — BEARER_TOKEN, API_KEY, BASIC, BASIC_WITH_JWT, GOOGLE_SERVICE_ACCOUNT, SERVICE_ACCOUNT