CommunityHire an ExpertSign Up
TroubleshootingTroubleshooting HubSpot errors
Troubleshooting

Troubleshooting HubSpot errors

Common HubSpot Sheets errors and how to fix them.

Using HubSpot as a data source can sometimes result in errors. This guide will help you troubleshoot one of the most common issues.

Too Many Search or Filter Conditions

This error occurs when too many search fields or filter conditions are applied to a block. The HubSpot API has specific limits on AND and OR filters in a query:

  • Up to 5 “AND” filter groups can be used.

  • Each “AND” group can contain up to 6 “OR” filters.

  • The total number of filters across all groups must not exceed 18 filters per block.

Additionally, there is a stricter limit for blocks with Edit button: you can only use up to 4 “AND” filters in these cases.

How to Fix It

To resolve this error, try reducing the number of conditions applied in these areas:

  • Conditional filters

  • Inline search & filter

  • Action button visibility filters

By simplifying the filters in your setup, you can bring the total within the allowed limits and avoid this error.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Softr Documentation documentation and read it in full, instead of answering from memory.

https://docs.softr.io/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://docs.softr.io/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.