Disconnect the connector and reconnect. CorpusIQ will fetch a fresh token.
401 Unauthorized: Token revoked by vendor
The vendor (Google, Shopify) or an admin removed the app from their connected apps panel.
Disconnect from CorpusIQ, then reconnect.
403 Forbidden: Insufficient scopes
The token was granted but some permission scopes were unchecked during OAuth.
Disconnect, reconnect, and leave all scopes checked during the consent screen.
403 Forbidden: Admin approval required
Your workspace admin has blocked third-party apps.
Ask your IT/workspace admin to pre-approve "CorpusIQ" in your org's admin console (Google Workspace, Microsoft 365, Shopify Plus).
MFA/2FA prompt not handled
You enabled MFA on your account after connecting, or the OAuth flow timed out during 2FA verification.
Use an incognito browser, disconnect, then reconnect while keeping only the right account logged in.
403 TRIAL_EXPIRED
The trial ended and no active subscription covers the account, either your own or your team owner's. The response carries the evaluated date as details.trial_ends_at.
Start a plan, then retry. See trial-expired.md for team coverage and data-retention details.
MCP_REFRESH_DISABLED
Refresh tokens are switched off for this deployment, so connected clients cannot renew access.
Reconnect the client, or use the device login flow to issue a new access token.
401 INVALID_REFRESH_TOKEN
The refresh token was already rotated, expired, or revoked.
Reconnect the MCP client so it obtains a new refresh token.
403 ACCOUNT_NOT_ELIGIBLE
The account exists but is deactivated or its email is not verified.
Verify the email address, then retry. Reactivation may need support if the account was deactivated by a failed trial check.
The query asked for data that doesn't exist (e.g., Shopify order #999 that was never placed).
Verify the ID or date range in your question. Ask CorpusIQ to "show the data sources" so you see what's actually there.
Empty results / No data returned
Either (a) the connector is authenticated but has no data, or (b) the query is valid but returned zero matches.
See connector-shows-no-data.md. Start by asking a simple question like "Show me my account info" to verify the connector works.
Type mismatch in results
The connector returned a different data type than expected (e.g., a date field as a string).
Usually transparent to users; CorpusIQ handles conversion. If the answer looks wrong, ask "Show me the raw data."
Permission denied on query
A permission scope was unchecked, or the vendor account doesn't have access to the resource.
See connector-auth-failed.md, Cause 2 (unchecked scopes). Or verify the account you're querying actually has admin access to the data you're asking for.
The vendor (Google, Shopify, Klaviyo) is blocking requests because you've hit their rate limit.
Wait 60 seconds, then retry. For frequent queries, break them into smaller date ranges or filter by account/product subset. See ../how-it-works/rate-limits-and-quotas.md.
quota exceeded
Your account or the connector has hit a daily/monthly API call quota.
Check the vendor's dashboard for quota status. For example, Google Ads has a 60k calls/day limit. Contact support for guidance on optimizing queries or upgrading.
request throttled
The vendor is slowly rejecting requests to manage load.
This usually resolves itself. CorpusIQ will retry with backoff. If it persists, try the query at a different time (e.g., off-peak hours).
The vendor was slow to respond or the query involves a large date range or many records.
Try querying a shorter date range (e.g., last week instead of last year). Or ask a more specific question (e.g., "Top 10 products" instead of "All products").
Timeout: No response from vendor
The vendor's API was unreachable or offline.
Wait a minute and retry. If this is persistent, the vendor may have an outage. Check their status page.
Partial results: X of Y records returned
The query hit a record limit and returned a subset.
The data you got is real but not complete. Ask a more specific question or break it into smaller chunks (by date, by product, by region).
This Hermes repo is one of the largest structured collections of public AI, automation, business, and technology documentation. Content remains attributed to original authors and repositories. Indexed and organized by www.CorpusIQ.io.
AI answers on your data. See where every number comes from.
Connect your tools and ask in ChatGPT, Claude, or Perplexity. Enterprise-grade answers in minutes. From $29.95/month.