Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: rewrite toolkit FAQ headings as questions and clean up answers
Sushmithamallesh2a7e80e05a60
diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdxindex 3d2d5bde2..aac3b6dc6 100644--- a/docs/content/docs/common-faq.mdx+++ b/docs/content/docs/common-faq.mdx@@ -142,18 +142,12 @@ Composio does not have fixed IP ranges. Traffic is routed through Cloudflare and<Accordion title="How do I increase my quota?">Upgrade your plan. See [pricing](https://composio.dev/pricing) for available plans and limits.</Accordion>--<Accordion title="Can Composio be self-hosted?">-Yes, Composio supports self-hosting on the Enterprise plan. See [pricing](https://composio.dev/pricing) for details or [talk to us](https://calendly.com/composiohq/enterprise).-</Accordion>-<Accordion title="How do I configure sessions with custom auth configs?">-Some toolkits require your own OAuth credentials or API keys. Create an auth config in the dashboard by selecting the toolkit, choosing the auth scheme, and entering your credentials. Then pass the auth config ID when creating a session using the `auth_configs` (or `auth_config_id`) parameter so the session uses your developer credentials instead of Composio‑managed auth.-See: https://docs.composio.dev/docs/using-custom-auth-configuration+Some toolkits require your own OAuth credentials or API keys. Create an auth config in the dashboard by selecting the toolkit, choosing the auth scheme, and entering your credentials. Then pass the auth config ID when creating a session using the `auth_configs` (or `auth_config_id`) parameter so the session uses your developer credentials instead of Composio-managed auth. See [Using custom auth configuration](/docs/using-custom-auth-configuration).</Accordion><Accordion title="How do I check complete logs / API calls from the SDK?">-Enable debug logging to view all API calls and network requests made by the SDK — this helps troubleshoot issues and provides request IDs for support.+Enable debug logging to view all API calls and network requests made by the SDK.Python:```bash@@ -165,7 +159,11 @@ TypeScript:COMPOSIO_LOG_LEVEL=debug```-See: https://docs.composio.dev/docs/troubleshooting/sdks+See [Troubleshooting SDKs](/docs/troubleshooting/sdks).+</Accordion>++<Accordion title="Can Composio be self-hosted?">+Yes, Composio supports self-hosting on the Enterprise plan. See [pricing](https://composio.dev/pricing) for details or [talk to us](https://calendly.com/composiohq/enterprise).</Accordion></Accordions>diff --git a/docs/content/toolkit-faq/calendly.md b/docs/content/toolkit-faq/calendly.mdindex b62d0158b..67755b688 100644--- a/docs/content/toolkit-faq/calendly.md+++ b/docs/content/toolkit-faq/calendly.md@@ -1,5 +1,3 @@-## Calendly Toolkit — FAQ--## Calendly has no scopes+## Why can't I configure individual scopes for Calendly?Calendly's OAuth model grants the access token for all requested scopes at once during authorization; users cannot selectively approve individual scopes. Configure scopes when creating your OAuth app — the resulting access token will include all requested permissions.diff --git a/docs/content/toolkit-faq/gmail.md b/docs/content/toolkit-faq/gmail.mdindex 437e5e178..1063a01b0 100644--- a/docs/content/toolkit-faq/gmail.md+++ b/docs/content/toolkit-faq/gmail.md@@ -2,29 +2,34 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client is requesting scopes Google hasn't verified for that client (often when extra granular scopes are added).-Fix: remove the extra scopes or create/use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Gmail?-## "Gmail API has not been used in project <ID> before or it is disabled"-Why it happens: when using custom OAuth credentials the Gmail API must be enabled in the Cloud project that owns those credentials.-Fix: enable the Gmail API in Google Cloud Console → APIs & Services, wait a few minutes for propagation, then retry.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid, unsupported, or misformatted in the auth URL.-Fix: verify scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Gmail API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token limits (~50 tokens). Reauthorization typically resolves 401s.+When using custom OAuth credentials, the Gmail API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.-## Gmail trigger is slow-Gmail triggers poll every ~1 minute by default (configurable); expect up to ~1 minute delay. If you need lower latency consider webhooks or Google pub/sub integrations.+## Why am I getting "Error 400: invalid_scope"?-## Why am I getting "Quota Exhausted" or "rate limit exhausted" on the service <SERVICE>.googleapis.com?-Google enforces request quotas (per‑minute and daily) to protect its APIs. If many clients share the same OAuth app, the shared quota can be exhausted and you may see quota errors.-Fixes: implement exponential backoff and retries, batch/cache requests to reduce rate, or use your own OAuth app credentials to avoid shared limits.+The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.++## Why is my Gmail trigger slow?++Gmail triggers poll roughly every minute by default. If you need lower latency, consider using webhooks or Google Pub/Sub integrations.++## Why am I getting "Quota Exhausted" or "rate limit exhausted"?++Google enforces per-minute and daily request quotas. If you're using Composio's default OAuth app, you share that quota with other users, which can cause limits to be hit faster. Use your own OAuth app credentials to get a dedicated quota, and add exponential backoff and retries to handle transient rate limits.---diff --git a/docs/content/toolkit-faq/google_classroom.md b/docs/content/toolkit-faq/google_classroom.mdindex 376f3071d..74950da25 100644--- a/docs/content/toolkit-faq/google_classroom.md+++ b/docs/content/toolkit-faq/google_classroom.md@@ -1,21 +1,27 @@-# Google Toolkits — FAQ+## How do I set up custom Google OAuth credentials for Google Classroom?For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client is requesting scopes Google hasn't verified for that client (often when extra granular scopes are added).-Fix: remove the extra scopes or create/use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Google Classroom?-## "Gmail API has not been used in project <ID> before or it is disabled"-Why it happens: when using custom OAuth credentials the Gmail API must be enabled in the Cloud project that owns those credentials.-Fix: enable the Gmail API in Google Cloud Console → APIs & Services, wait a few minutes for propagation, then retry.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid, unsupported, or misformatted in the auth URL.-Fix: verify scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Classroom API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token limits (~50 tokens). Reauthorization typically resolves 401s.+When using custom OAuth credentials, the Google Classroom API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.++## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.++---diff --git a/docs/content/toolkit-faq/google_maps.md b/docs/content/toolkit-faq/google_maps.mdindex 5ce488073..acb478cf5 100644--- a/docs/content/toolkit-faq/google_maps.md+++ b/docs/content/toolkit-faq/google_maps.md@@ -1,21 +1,27 @@-## Google Toolkits — FAQ+## How do I set up custom Google OAuth credentials for Google Maps?-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client requests scopes Google hasn't verified for that client (often because extra granular scopes were added).-Fix: remove the extra scopes or create and use your own OAuth app and submit scopes for verification — see the [Create OAuth app guide](https://composio.dev/auth/googleapps).+For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the specific Google API (Sheets, Drive, Gmail, Slides, etc.) is not enabled for the Cloud project tied to your OAuth credentials.-Fix: open Google Cloud Console → APIs & Services → enable the required API, then wait a few minutes and retry.+## Why am I seeing "App is blocked" when connecting Google Maps?-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid, unsupported, or misformatted in the authorization URL.-Fix: verify scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and configure a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy changes, or refresh‑token limits (~50 tokens). Reauthorization generally resolves 401s.+## Why am I getting "Google Maps API has not been used in project" error?++When using custom OAuth credentials, the Google Maps API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.++## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.---diff --git a/docs/content/toolkit-faq/googlecalendar.md b/docs/content/toolkit-faq/googlecalendar.mdindex 5966e2a1e..8f4d4b46d 100644--- a/docs/content/toolkit-faq/googlecalendar.md+++ b/docs/content/toolkit-faq/googlecalendar.md@@ -2,23 +2,26 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client requests scopes that aren't verified for that client (common when adding extra scopes).-Fix: remove extra scopes or create/use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Google Calendar?-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the Calendar API is not enabled for the Cloud project tied to your OAuth credentials.-Fix: enable the Calendar API in Google Cloud Console → APIs & Services, then wait a few minutes and retry.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid or misformatted.-Fix: verify scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Calendar API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, admin policy, or refresh‑token limits (~50). Reauthorization typically resolves 401s.+When using custom OAuth credentials, the Google Calendar API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.++## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.-------\ No newline at end of filediff --git a/docs/content/toolkit-faq/googledocs.md b/docs/content/toolkit-faq/googledocs.mdindex 26d1b7036..6d82ac722 100644--- a/docs/content/toolkit-faq/googledocs.md+++ b/docs/content/toolkit-faq/googledocs.md@@ -2,27 +2,30 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client is requesting scopes Google hasn't verified for that client (often due to extra granular scopes).-Fix: remove the extra scopes or create/use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Google Docs?-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the Docs API isn't enabled for the Cloud project tied to your OAuth credentials.-Fix: enable the Docs API in Google Cloud Console → APIs & Services, then wait a few minutes and retry.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid, unsupported, or misformatted.-Fix: validate scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Docs API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token limits (~50). Reauthorization usually resolves 401s.+When using custom OAuth credentials, the Google Docs API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.-----## Why am I getting "Quota Exhausted" or "rate limit exhausted" on the service <SERVICE>.googleapis.com?-Google enforces request quotas (per‑minute and daily) to protect its APIs. Shared/default OAuth apps can hit these quotas under load, causing quota errors.-Fixes: use exponential backoff with retries, batch or cache requests to reduce the call rate, or use your own OAuth app credentials to avoid shared limits.+## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.++## Why am I getting "Quota Exhausted" or "rate limit exhausted"?++Google enforces per-minute and daily request quotas. If you're using Composio's default OAuth app, you share that quota with other users, which can cause limits to be hit faster. Use your own OAuth app credentials to get a dedicated quota, and add exponential backoff and retries to handle transient rate limits.---diff --git a/docs/content/toolkit-faq/googledrive.md b/docs/content/toolkit-faq/googledrive.mdindex 358548dbe..86f3dead9 100644--- a/docs/content/toolkit-faq/googledrive.md+++ b/docs/content/toolkit-faq/googledrive.md@@ -2,23 +2,26 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client is requesting scopes Google hasn't verified (often after adding extra scopes).-Fix: remove the additional scopes or create/use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Google Drive?-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the Drive API is not enabled for the Cloud project tied to your OAuth credentials.-Fix: enable the Drive API in Google Cloud Console → APIs & Services; wait a few minutes and retry.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: scopes are invalid, unsupported, or misformatted in the auth URL.-Fix: validate scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Drive API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, admin policy, or refresh‑token limits (~50). Reauthorization typically resolves the issue.+When using custom OAuth credentials, the Google Drive API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.++## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.-------diff --git a/docs/content/toolkit-faq/googlemeet.md b/docs/content/toolkit-faq/googlemeet.mdindex 3b5137fc3..429b6dd11 100644--- a/docs/content/toolkit-faq/googlemeet.md+++ b/docs/content/toolkit-faq/googlemeet.md@@ -2,27 +2,30 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client requests scopes that aren't verified for that app (often due to added granular scopes).-Fix: remove the extra scopes or use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Google Meet?-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the Meet API is not enabled for the Cloud project tied to your OAuth credentials.-Fix: enable the Meet API in Google Cloud Console → APIs & Services, then wait a few minutes and retry.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid or misformatted in the auth URL.-Fix: verify scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Meet API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token limits (~50). Reauthorize when needed.+When using custom OAuth credentials, the Google Meet API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.-----## Why am I getting "Quota Exhausted" or "rate limit exhausted" on the service <SERVICE>.googleapis.com?-Google enforces request quotas (per‑minute and daily) to protect its APIs. When many clients use the same OAuth app, shared quotas can be exhausted and cause these errors.-Fixes: implement exponential backoff and retries, batch/cache requests to reduce the rate, or use your own OAuth app credentials to avoid shared limits.+## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.++## Why am I getting "Quota Exhausted" or "rate limit exhausted"?++Google enforces per-minute and daily request quotas. If you're using Composio's default OAuth app, you share that quota with other users, which can cause limits to be hit faster. Use your own OAuth app credentials to get a dedicated quota, and add exponential backoff and retries to handle transient rate limits.---diff --git a/docs/content/toolkit-faq/googlesheets.md b/docs/content/toolkit-faq/googlesheets.mdindex 3aa1c1a54..e6a62789f 100644--- a/docs/content/toolkit-faq/googlesheets.md+++ b/docs/content/toolkit-faq/googlesheets.md@@ -2,27 +2,30 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client requests scopes Google hasn't verified for that client (often due to added granular scopes).-Fix: remove the extra scopes or create/use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Google Sheets?-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the Google Sheets API isn't enabled for the Cloud project tied to your OAuth credentials.-Fix: enable the Sheets API in Google Cloud Console → APIs & Services, then wait a few minutes and retry.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid or misformatted in the auth URL.-Fix: verify scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Sheets API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy changes, or refresh‑token limits (~50 tokens). Reauthorization typically resolves 401s.+When using custom OAuth credentials, the Google Sheets API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.-----## Why am I getting "Quota Exhausted" or "rate limit exhausted" on the service <SERVICE>.googleapis.com?-Google enforces request quotas (per‑minute and daily) to protect its APIs. Shared default OAuth apps can reach those limits under high traffic, causing quota errors.-Fixes: add exponential backoff and retries, batch or cache requests to lower the rate, or use your own OAuth app credentials to avoid shared quotas.+## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.++## Why am I getting "Quota Exhausted" or "rate limit exhausted"?++Google enforces per-minute and daily request quotas. If you're using Composio's default OAuth app, you share that quota with other users, which can cause limits to be hit faster. Use your own OAuth app credentials to get a dedicated quota, and add exponential backoff and retries to handle transient rate limits.---diff --git a/docs/content/toolkit-faq/googleslides.md b/docs/content/toolkit-faq/googleslides.mdindex 0a99ac5f9..44536393d 100644--- a/docs/content/toolkit-faq/googleslides.md+++ b/docs/content/toolkit-faq/googleslides.md@@ -2,27 +2,30 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client requests scopes Google hasn't verified for that client (common when extra granular scopes are added).-Fix: remove extra scopes or create/use your own OAuth app and submit scopes for verification (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)).+## Why am I seeing "App is blocked" when connecting Google Slides?-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the Cloud project that owns your OAuth credentials doesn't have the required API enabled.-Fix: enable the API (Google Cloud Console → APIs & Services) and wait a few minutes for propagation.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid or misformatted in the auth URL.-Fix: validate scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label, create and use your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Slides API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token limits (~50). Reauthorize when needed.+When using custom OAuth credentials, the Google Slides API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.-----## Why am I getting "Quota Exhausted" or "rate limit exhausted" on the service <SERVICE>.googleapis.com?-Google enforces quotas to limit request rates (per‑minute and daily). Shared default OAuth apps can hit these quotas under heavy use, causing "Quota Exhausted" errors.-Fixes: add exponential backoff/retries, reduce request frequency (batch/cache), or use your own OAuth app credentials to avoid shared limits.+## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.++## Why am I getting "Quota Exhausted" or "rate limit exhausted"?++Google enforces per-minute and daily request quotas. If you're using Composio's default OAuth app, you share that quota with other users, which can cause limits to be hit faster. Use your own OAuth app credentials to get a dedicated quota, and add exponential backoff and retries to handle transient rate limits.---diff --git a/docs/content/toolkit-faq/googlesuper.md b/docs/content/toolkit-faq/googlesuper.mdindex 4cc91e240..77a0117c2 100644--- a/docs/content/toolkit-faq/googlesuper.md+++ b/docs/content/toolkit-faq/googlesuper.md@@ -1,18 +1,23 @@-## Google Toolkits — FAQ+## How do I set up custom Google OAuth credentials for Google Super?-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client requests scopes Google hasn't verified for that client (often because extra granular scopes were added).-Fix: remove the extra scopes or create and use your own OAuth app and submit scopes for verification — see the [Create OAuth app guide](https://composio.dev/auth/googleapps).+For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: the specific Google API (Sheets, Drive, Gmail, Slides, etc.) is not enabled for the Cloud project tied to your OAuth credentials.-Fix: open Google Cloud Console → APIs & Services → enable the required API, then wait a few minutes and retry.+## Why am I seeing "App is blocked" when connecting Google Super?-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: requested scopes are invalid, unsupported, or misformatted in the authorization URL.-Fix: verify scopes against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create and use your own OAuth app and configure a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).++## Why am I getting the "API has not been used in project" error?++When using custom OAuth credentials, the required Google API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.++## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).---diff --git a/docs/content/toolkit-faq/googletasks.md b/docs/content/toolkit-faq/googletasks.mdindex fa514230e..686230769 100644--- a/docs/content/toolkit-faq/googletasks.md+++ b/docs/content/toolkit-faq/googletasks.md@@ -2,27 +2,30 @@For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## "App is blocked" warning while connecting to Google apps-Why it happens: the OAuth client is requesting scopes Google hasn't verified for that app. If you're using Composio's default OAuth client this usually means you added extra scopes beyond the defaults.-Fix: either remove the extra scope(s) or create and use your own OAuth app (see the [Create OAuth app guide](https://composio.dev/auth/googleapps)) and submit scopes for verification.+## Why am I seeing "App is blocked" when connecting Google Tasks?-## "<Google App Name> API has not been used in project <ID> before or it is disabled"-Why it happens: when using your own OAuth credentials the corresponding Google API (Sheets, Drive, Gmail, etc.) must be enabled in the Cloud project.-Fix: open Google Cloud Console → APIs & Services → Enable the required API, then wait a few minutes for propagation.+The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.-## Access blocked: Authorization Error (Error 400: invalid_scope)-Why it happens: scopes are invalid, unsupported, or misformatted in the auth URL.-Fix: verify scopes against Google's docs (see the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2)) and follow the [programmatic authConfig guide](https://docs.composio.dev/docs/programmatic-auth-configs).+Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).-## Composio name shown on the OAuth consent screen-To white‑label the consent screen, create your own OAuth app and set a custom redirect URL. See the [white‑label OAuth guide](https://docs.composio.dev/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).+## Why am I getting "Google Tasks API has not been used in project" error?-## 401 errors for tool calls-Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token rotation/limits (~50 tokens). If a connection fails, ask the user to reauthorize.+When using custom OAuth credentials, the Google Tasks API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.-----## Why am I getting "Quota Exhausted" or "rate limit exhausted" on the service <SERVICE>.googleapis.com?-Google enforces request quotas to protect its services (per‑minute and daily limits). If many users share the default OAuth client, you may hit a shared quota and see "Quota Exhausted" errors.-Fixes: implement exponential backoff and retries, reduce request rates (batch/cache), or use your own OAuth app credentials to avoid shared quotas.+## Why am I getting "Error 400: invalid_scope"?++The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](/docs/programmatic-auth-configs).++## Why does the OAuth consent screen show "Composio" instead of my app?++By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling the OAuth consent screen](/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen).++## Why am I getting 401 errors on tool calls?++The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.++## Why am I getting "Quota Exhausted" or "rate limit exhausted"?++Google enforces per-minute and daily request quotas. If you're using Composio's default OAuth app, you share that quota with other users, which can cause limits to be hit faster. Use your own OAuth app credentials to get a dedicated quota, and add exponential backoff and retries to handle transient rate limits.---