Authentication

Using Composio’s default OAuth app

When using our default OAuth configuration:

• Don’t add additional scopes - They may not be approved in our OAuth app
• Use only the pre-configured scopes provided

Using custom OAuth apps

Ensure your OAuth app is configured correctly:

• Redirect URL: Must match exactly what’s configured in your OAuth provider
• Scopes: Auth config scopes must match your OAuth app configuration
• Credentials: Verify client ID and secret are correct

For setup guides by toolkit: OAuth Configuration Guides

Common authentication issues

• Invalid redirect URI: Check the callback URL matches exactly
• Scope mismatch: Ensure requested scopes are configured in both auth config and OAuth app
• Expired tokens: Try refreshing the connection
• Rate limits: Some providers limit authentication attempts

Reporting authentication issues

When reporting to support, provide:

• Error message: Complete error details and screenshots
• Auth config ID: The authConfigId being used
• Connected account ID: If a connection was already created
• OAuth provider: Which service you’re trying to connect

Getting help

• Email: support@composio.dev
• Discord: #support-form