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
toolkit-faqs
Uday-sidagana0ff328d3875d
diff --git a/docs/content/toolkit-faq/calendly.md b/docs/content/toolkit-faq/calendly.mdnew file mode 100644index 000000000..b62d0158b--- /dev/null+++ b/docs/content/toolkit-faq/calendly.md@@ -0,0 +1,5 @@+## Calendly Toolkit — FAQ++## Calendly has no scopes+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 490c499f1..437e5e178 100644--- a/docs/content/toolkit-faq/gmail.md+++ b/docs/content/toolkit-faq/gmail.md@@ -1,3 +1,30 @@## How do I set up custom Google OAuth credentials for Gmail?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)).++## "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.++## 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).++## 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).++## 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.++## 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 "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.++---diff --git a/docs/content/toolkit-faq/google_classroom.md b/docs/content/toolkit-faq/google_classroom.mdnew file mode 100644index 000000000..376f3071d--- /dev/null+++ b/docs/content/toolkit-faq/google_classroom.md@@ -0,0 +1,21 @@+# Google Toolkits — FAQ++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)).++## "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.++## 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).++## 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).++## 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.diff --git a/docs/content/toolkit-faq/google_maps.md b/docs/content/toolkit-faq/google_maps.mdnew file mode 100644index 000000000..5ce488073--- /dev/null+++ b/docs/content/toolkit-faq/google_maps.md@@ -0,0 +1,21 @@+## Google Toolkits — FAQ++## "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).++## "<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.++## 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).++## 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).++## 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.++---diff --git a/docs/content/toolkit-faq/googlecalendar.md b/docs/content/toolkit-faq/googlecalendar.mdindex c45eda650..5966e2a1e 100644--- a/docs/content/toolkit-faq/googlecalendar.md+++ b/docs/content/toolkit-faq/googlecalendar.md@@ -1,3 +1,24 @@## How do I set up custom Google OAuth credentials for Google Calendar?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)).++## "<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.++## 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).++## 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).++## 401 errors for tool calls+Common causes: user revoked access, password/2FA change, admin policy, or refresh‑token limits (~50). Reauthorization typically resolves 401s.++---+---\ No newline at end of filediff --git a/docs/content/toolkit-faq/googledocs.md b/docs/content/toolkit-faq/googledocs.mdindex 12801555a..26d1b7036 100644--- a/docs/content/toolkit-faq/googledocs.md+++ b/docs/content/toolkit-faq/googledocs.md@@ -1,3 +1,28 @@## How do I set up custom Google OAuth credentials for Google Docs?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)).++## "<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.++## 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).++## 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).++## 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.++---+## 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.++---diff --git a/docs/content/toolkit-faq/googledrive.md b/docs/content/toolkit-faq/googledrive.mdindex 6603d2600..358548dbe 100644--- a/docs/content/toolkit-faq/googledrive.md+++ b/docs/content/toolkit-faq/googledrive.md@@ -1,3 +1,24 @@## How do I set up custom Google OAuth credentials for Google Drive?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)).++## "<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.++## 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).++## 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).++## 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.++---+---diff --git a/docs/content/toolkit-faq/googlemeet.md b/docs/content/toolkit-faq/googlemeet.mdindex f23f4d5eb..3b5137fc3 100644--- a/docs/content/toolkit-faq/googlemeet.md+++ b/docs/content/toolkit-faq/googlemeet.md@@ -1,3 +1,28 @@## How do I set up custom Google OAuth credentials for Google Meet?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)).++## "<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.++## 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).++## 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).++## 401 errors for tool calls+Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token limits (~50). Reauthorize when needed.++---+## 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.++---diff --git a/docs/content/toolkit-faq/googlesheets.md b/docs/content/toolkit-faq/googlesheets.mdindex c91419df5..3aa1c1a54 100644--- a/docs/content/toolkit-faq/googlesheets.md+++ b/docs/content/toolkit-faq/googlesheets.md@@ -1,3 +1,28 @@## How do I set up custom Google OAuth credentials for Google Sheets?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)).++## "<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.++## 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).++## 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).++## 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.++---+## 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.++---diff --git a/docs/content/toolkit-faq/googleslides.md b/docs/content/toolkit-faq/googleslides.mdindex e3827c8e8..0a99ac5f9 100644--- a/docs/content/toolkit-faq/googleslides.md+++ b/docs/content/toolkit-faq/googleslides.md@@ -1,3 +1,28 @@## How do I set up custom Google OAuth credentials for Google Slides?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)).++## "<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.++## 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).++## 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).++## 401 errors for tool calls+Common causes: user revoked access, password/2FA change, Workspace admin policy, or refresh‑token limits (~50). Reauthorize when needed.++---+## 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.++---diff --git a/docs/content/toolkit-faq/googlesuper.md b/docs/content/toolkit-faq/googlesuper.mdnew file mode 100644index 000000000..4cc91e240--- /dev/null+++ b/docs/content/toolkit-faq/googlesuper.md@@ -0,0 +1,18 @@+## Google Toolkits — FAQ++## "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).++## "<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.++## 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).++## 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).++---diff --git a/docs/content/toolkit-faq/googletasks.md b/docs/content/toolkit-faq/googletasks.mdindex 7b781a70c..fa514230e 100644--- a/docs/content/toolkit-faq/googletasks.md+++ b/docs/content/toolkit-faq/googletasks.md@@ -1,3 +1,28 @@## How do I set up custom Google OAuth credentials for Google Tasks?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.++## "<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.++## 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).++## 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).++## 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.++---+## 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.++---diff --git a/docs/content/toolkit-faq/hubspot.md b/docs/content/toolkit-faq/hubspot.mdindex e1aa78460..cf3487e98 100644--- a/docs/content/toolkit-faq/hubspot.md+++ b/docs/content/toolkit-faq/hubspot.md@@ -1,3 +1,9 @@## How do I set up custom OAuth credentials for HubSpot?For a step-by-step guide on creating and configuring your own HubSpot OAuth credentials with Composio, see [How to create OAuth credentials for HubSpot](https://composio.dev/auth/hubspot).++## Query limits+Use `limit <= 100` for `HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA` and `HUBSPOT_LIST_CONTACTS_PAGE` endpoints to avoid errors.++## Webhooks+Webhooks require public apps (AppId + Developer API Key). Private/internal apps cannot receive HubSpot webhooks.diff --git a/docs/content/toolkit-faq/jira.md b/docs/content/toolkit-faq/jira.mdindex 0150cce52..28540782a 100644--- a/docs/content/toolkit-faq/jira.md+++ b/docs/content/toolkit-faq/jira.md@@ -1,3 +1,10 @@## How do I set up custom OAuth credentials for Jira?For a step-by-step guide on creating and configuring your own Jira OAuth credentials with Composio, see [How to create OAuth credentials for Jira](https://composio.dev/auth/jira).++## JQL GET vs POST and Search Issues+- JQL GET and POST target the same search functionality but use different HTTP methods. POST supports complex queries in the request body.+- Use the `fields` parameter to request specific fields; responses may include empty values if fields are undefined. Use `["*all"]` to request all fields.++## Difference: JQL GET vs POST vs Search Issues+Search Issues uses JQL POST under the hood and supports extra parameters/filters. For consistent results prefer POST when submitting complex queries.diff --git a/docs/content/toolkit-faq/linkedin.md b/docs/content/toolkit-faq/linkedin.mdindex 4fe0b0285..9ac993824 100644--- a/docs/content/toolkit-faq/linkedin.md+++ b/docs/content/toolkit-faq/linkedin.md@@ -1,3 +1,12 @@## How do I set up custom OAuth credentials for LinkedIn?For a step-by-step guide on creating and configuring your own LinkedIn OAuth credentials with Composio, see [How to create OAuth credentials for LinkedIn](https://composio.dev/auth/linkedin).++## LinkedIn rate limiting+LinkedIn's default OAuth app is shared across users and has strict rate limits. Use a custom OAuth app for production to avoid shared quotas. Example error:+```bash+429 Client Error: Too Many Requests+```++## LinkedIn scope issue+LinkedIn restricts certain scope combinations (e.g., `w_member_social` and `r_organization_admin` cannot be used together). If you need conflicting scopes, create your own OAuth app with the required permissions.diff --git a/docs/content/toolkit-faq/monday.md b/docs/content/toolkit-faq/monday.mdindex 4b3f0b03f..2afda88dc 100644--- a/docs/content/toolkit-faq/monday.md+++ b/docs/content/toolkit-faq/monday.md@@ -17,3 +17,28 @@ No. The admin only needs to install the app once per workspace. After that, any## How do I set up custom OAuth credentials for Monday.com?For a step-by-step guide on creating and configuring your own Monday.com OAuth credentials with Composio, see [How to create OAuth2 credentials for Monday](https://composio.dev/auth/monday).++## Monday has no scopes+Note: Monday's authConfig does not accept scopes in the same way Google does. Scopes are configured on the OAuth app itself. When using the default OAuth app, ensure the required app-level scopes are configured for full toolkit access. If creating a custom app, add these scopes as needed:++```bash+me:read+boards:read+boards:write+docs:read+docs:write+workspaces:read+workspaces:write+users:read+users:write+account:read+notifications:write+updates:read+updates:write+assets:read+tags:read+teams:read+teams:write+webhooks:write+webhooks:read+```diff --git a/docs/content/toolkit-faq/notion.md b/docs/content/toolkit-faq/notion.mdnew file mode 100644index 000000000..a9b373535--- /dev/null+++ b/docs/content/toolkit-faq/notion.md@@ -0,0 +1,21 @@+## Notion Toolkit — FAQ++## Notion Operations show Composio instead of user’s name+Why it happens: Notion attributes actions to the Integration itself (name/logo set in the Integration configuration), so operations and comments show the integration identity rather than the individual user.+Fix: create and use your own Notion integration if you need a custom name/logo. See: https://developers.notion.com/docs/create-a-notion-integration++## Granting access to more pages+If you initially granted access to specific pages and later need to add more:+1. Open Notion → Settings & Members → Connections+2. Select the integration (Composio or your custom integration)+3. Click "Select pages" (or "Manage access") and add/remove pages as required++## Notion has no scopes+Notion does not use OAuth scopes. Instead, integrations are granted access to specific resources (pages/databases) during the authorization flow or via integration settings. You do not need to pass scopes when creating an authConfig.++## Configuring Scopes / Access model+Notion access is controlled by the integration type:+- OAuth app (public): access selection happens at authorization time.+- Internal integration (API key): page access is managed in the Integration settings.+Choose the integration model that matches your deployment and permissions needs.+diff --git a/docs/content/toolkit-faq/one_drive.md b/docs/content/toolkit-faq/one_drive.mdnew file mode 100644index 000000000..2c4a49574--- /dev/null+++ b/docs/content/toolkit-faq/one_drive.md@@ -0,0 +1,11 @@+## OneDrive Toolkit — FAQ++## Why am I getting 404 on `ONE_DRIVE_DOWNLOAD_FILE` for my shared file?+Cause: items shown in "Shared" may be references to files that live in a SharePoint site (not actual files in the user's OneDrive). Those referenced items cannot be downloaded via the OneDrive item endpoints.++Fix:+- Open the file's location in OneDrive/SharePoint and choose **Copy to → My files** to create a real copy in the user's OneDrive.+- After the copy completes, download the copied file with `ONE_DRIVE_DOWNLOAD_FILE`.++Note: if you need programmatic access to files stored in SharePoint sites, use the SharePoint APIs or ensure the file is copied into the user's OneDrive first.+diff --git a/docs/content/toolkit-faq/outlook.md b/docs/content/toolkit-faq/outlook.mdindex fa4520779..6f90f6bfe 100644--- a/docs/content/toolkit-faq/outlook.md+++ b/docs/content/toolkit-faq/outlook.md@@ -1,3 +1,13 @@## How do I set up custom OAuth credentials for Microsoft (Outlook)?For a step-by-step guide on creating and configuring your own Microsoft (Outlook) OAuth credentials with Composio, see [How to create OAuth credentials for Microsoft (Outlook)](https://composio.dev/auth/outlook).++## Outlook new message trigger only sends the message ID+Outlook's official webhooks send only the message payload ID on trigger events. To fetch the full message (subject, body, headers), call the `OUTLOOK_GET_MESSAGE` tool with that message ID.++## I cannot see the sent message details while using OUTLOOK_SEND_EMAIL+Why: Microsoft Graph's send endpoint returns an HTTP 202 with no message details. Workaround: create a draft first with `OUTLOOK_CREATE_DRAFT` (this returns conversationID and messageID), then send the draft using `OUTLOOK_SEND_DRAFT` to obtain those IDs.+Reference: https://learn.microsoft.com/en-us/graph/api/user-sendmail?view=graph-rest-1.0&tabs=http++## What's the @odata.context / @odata URL?+The `@odata.context` URL provides metadata about the response (entity set, service version, and schema info) to help clients interpret the payload structure. It's primarily used for pagination and data parsing — not as a direct URL to the resource itself.diff --git a/docs/content/toolkit-faq/pipedrive.md b/docs/content/toolkit-faq/pipedrive.mdindex 9e6f191d9..18b595817 100644--- a/docs/content/toolkit-faq/pipedrive.md+++ b/docs/content/toolkit-faq/pipedrive.md@@ -1,3 +1,6 @@## How do I set up custom OAuth credentials for Pipedrive?For a step-by-step guide on creating and configuring your own Pipedrive OAuth credentials with Composio, see [How to create OAuth credentials for Pipedrive](https://composio.dev/auth/pipedrive).++## App not found+If you see "App is not found" when connecting, Composio's default Pipedrive OAuth credentials may have expired. Use your own OAuth app credentials until the default is restored.diff --git a/docs/content/toolkit-faq/quickbooks.md b/docs/content/toolkit-faq/quickbooks.mdnew file mode 100644index 000000000..ab5333ea9--- /dev/null+++ b/docs/content/toolkit-faq/quickbooks.md@@ -0,0 +1,9 @@+## QuickBooks Toolkit — FAQ++## Why am I seeing a DNS error while connecting my account?+Cause: this commonly happens when the `com.intuit.quickbooks.payment` scope is included in your `authConfig` but the connected QuickBooks account hasn't enabled the Payments module. The Payments scope requires the Payments feature to be active on the QuickBooks side.++Fix:+- Remove the `com.intuit.quickbooks.payment` scope from the `authConfig` and reconnect, or+- Enable/complete the Payments module in the QuickBooks account you’re connecting, then retry the connection.+diff --git a/docs/content/toolkit-faq/salesforce.md b/docs/content/toolkit-faq/salesforce.mdindex 15ab66399..e13781410 100644--- a/docs/content/toolkit-faq/salesforce.md+++ b/docs/content/toolkit-faq/salesforce.md@@ -1,3 +1,20 @@## How do I set up custom OAuth credentials for Salesforce?For a step-by-step guide on creating and configuring your own Salesforce OAuth credentials with Composio, see [How to create OAuth credentials for Salesforce](https://composio.dev/auth/salesforce).++## Can’t find created items?+If created items don't appear in Salesforce UI, use search to confirm they exist (records may be present but not visible in a given view).++## Relationships: Pricebooks and Opportunities+Salesforce relationships example: Products → Pricebooks → Opportunities. Example query:+```sql+SELECT Id, Name,+ (SELECT Id, Quantity, UnitPrice, TotalPrice, PricebookEntry.Product2.Name FROM OpportunityLineItems)+FROM Opportunity+```++## Connection initiation+Required fields for connection: subdomain (your-company.my) and instance endpoint `/services/data/v61.0`. If you see `URL_NOT_RESET`, replace `login` subdomain with your organization’s subdomain.++## Deprecated tools+Deprecated tools continue to work until removed. Check tool descriptions for "DEPRECATED:" markers.diff --git a/docs/content/toolkit-faq/shopify.md b/docs/content/toolkit-faq/shopify.mdindex dce1edb75..0c58f340b 100644--- a/docs/content/toolkit-faq/shopify.md+++ b/docs/content/toolkit-faq/shopify.md@@ -1,3 +1,6 @@## How do I set up custom OAuth credentials for Shopify?For a step-by-step guide on creating and configuring your own Shopify OAuth credentials with Composio, see [How to create OAuth credentials for Shopify](https://composio.dev/auth/shopify).++## Shopify — App not found+Our default Shopify OAuth app may be under review or expired. If you see "App not found" when connecting, use your own OAuth app or API authentication method. We're working with Shopify to restore the default app.diff --git a/docs/content/toolkit-faq/slack.md b/docs/content/toolkit-faq/slack.mdindex acacf4d4a..a8183ca66 100644--- a/docs/content/toolkit-faq/slack.md+++ b/docs/content/toolkit-faq/slack.md@@ -1,3 +1,35 @@## How do I set up custom OAuth credentials for Slack?For a step-by-step guide on creating and configuring your own Slack OAuth credentials with Composio, see [How to create OAuth credentials for Slack](https://composio.dev/auth/slack).++## Slack vs Slackbot — key differences+- Scope: Slack = workspace-level API (channels, files, users); Slackbot = bot-centric messaging/interactivity.+- Triggers: Slack = workspace events; Slackbot = bot entry points (app_mention, DMs, slash commands).+- Actions: Slack can manage channels/files/users; Slackbot focuses on messaging, ephemeral messages, and modals.+- Message identity: Slack can post as app; Slackbot posts as the bot user.+- Use cases: Slack for workspace management; Slackbot for conversational UX and bot flows.++## Docs & Scopes+See Slack Developer Docs: https://docs.slack.dev/reference/scopes/++## Redirect URI mismatch+Update in Slack App → OAuth & Permissions → Redirect URLs.++## Using Webhooks (Events)+1. Enable Event Subscriptions in your Slack app.+2. Set Request URL to: `https://backend.composio.dev/api/v3/trigger_instances/slack/default/handle`+3. Add `reaction_added` (and other events) to Subscribe to Bot Events and save.+- If using Composio Slack app: you're all set.+- If using Slackbot integration: add the bot to channels you want to monitor (or use /add to add Composio App).++## Scope Errors+1. Missing bot scope → add a bot scope under OAuth & Permissions.+2. "Insufficient scopes" → ensure all scopes from your Auth Config are configured in the Slack app.++## Action-specific notes+- `as_user` parameter: Slack API — set `as_user=True`; Slackbot — leave blank (defaults False).+- `missing_charset` error: usually due to invalid `as_user`, wrong channel ID, or missing required fields.++## Cannot use Triggers+Provide the Verification Token (or signing secret) in the Auth Config so Composio can validate incoming events.+diff --git a/docs/content/toolkit-faq/snowflake.md b/docs/content/toolkit-faq/snowflake.mdindex 5db65c746..9505198df 100644--- a/docs/content/toolkit-faq/snowflake.md+++ b/docs/content/toolkit-faq/snowflake.md@@ -1,3 +1,20 @@## How do I set up custom OAuth credentials for Snowflake?For a step-by-step guide on creating and configuring your own Snowflake OAuth credentials with Composio, see [How to create OAuth credentials for Snowflake](https://composio.dev/auth/snowflake).++## Create Snowflake OAuth app (example)+Example Snowflake SQL to create a security integration for OAuth:+```sql+CREATE SECURITY INTEGRATION oauth_custom_all_roles+ TYPE = oauth+ ENABLED = true+ OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'+ OAUTH_REDIRECT_URI = 'https://your-app.com/oauth/callback'+ OAUTH_REFRESH_TOKEN_VALIDITY = 7776000;+```++## Roles and config+Ensure the OAuth app and Snowflake roles/databases/schemas are configured correctly for the integration.++## Customer integration notes+Snowflake requires per-customer OAuth credentials; customers often supply their own credentials when integrating with Composio.diff --git a/docs/content/toolkit-faq/spotify.md b/docs/content/toolkit-faq/spotify.mdnew file mode 100644index 000000000..d1ae9bfce--- /dev/null+++ b/docs/content/toolkit-faq/spotify.md@@ -0,0 +1,5 @@+## Spotify Toolkit — FAQ++## No default OAuth app+We do not provide a default OAuth app for Spotify. You can use your own OAuth app for production. We're in contact with Spotify for approval but recommend creating your own app in the meantime.+diff --git a/docs/content/toolkit-faq/twitter.md b/docs/content/toolkit-faq/twitter.mdnew file mode 100644index 000000000..23d15c109--- /dev/null+++ b/docs/content/toolkit-faq/twitter.md@@ -0,0 +1,15 @@+## Twitter Toolkit — FAQ++## Twitter rate limiting+Why it happens: the default OAuth app is shared across users and subject to strict rate limits. Good for testing; for production use your own OAuth app.+Example error(for ref only):+```bash+error: 'Request failed error: "{"account_id": <ID>, "product_name": "standard-basic" ',"title" : "UsageCapExceeded", "period" : "Monthly", "scope" : "Product", "detail": "Usage cap exceeded: Monthly product cap", "type": "https://api.twitter.com/2/problems/usage-capped"}"+```++## Twitter plan-based API access+Twitter enforces plan-based access tiers. Check your project's product/plan for required permissions: https://developer.x.com/en/portal/products++## Twitter 403s on API calls+Why it happens: your developer account/project may not have the required access level for the endpoint. Example 403 response explains missing enrollment or required level.+diff --git a/docs/content/toolkit-faq/whatsapp.md b/docs/content/toolkit-faq/whatsapp.mdnew file mode 100644index 000000000..a1d36baee--- /dev/null+++ b/docs/content/toolkit-faq/whatsapp.md@@ -0,0 +1,8 @@+## WhatsApp Toolkit — FAQ++## Sending messages+The `WHATSAPP_SEND_MESSAGE` tool follows the customer service window: recipients only receive messages within 24 hours of their last message, unless you use a template message which can be sent outside the window.++## Connection initiation fail+If integration initiation fails with errors like `Missing required fields: generic_id`, ensure required fields are provided. See integration docs: https://docs.composio.dev/toolkits/whatsapp#authentication-details+diff --git a/docs/content/toolkit-faq/youtube.md b/docs/content/toolkit-faq/youtube.mdnew file mode 100644index 000000000..cf4365777--- /dev/null+++ b/docs/content/toolkit-faq/youtube.md@@ -0,0 +1,15 @@+## YouTube Toolkit — FAQ++## How do I set up custom Google OAuth credentials for YouTube?+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).++## YouTube rate limit+YouTube's default OAuth app is shared and subject to strict quota limits. For production use, create and use your own OAuth app to avoid shared quotas. Typical error when quota is exceeded:+```bash+{+ "error": {+ "code": 403,+ "message": "The request cannot be completed because you have exceeded your quota",+ }+}+```