# FAQ

<details>

<summary>Which HubSpot plan do I need to use Coupler.io?</summary>

Coupler.io connects to HubSpot via OAuth and works with any HubSpot plan including Free. However, some entities require specific Hubs — for example, Tickets require Service Hub, Marketing emails require Marketing Hub, and Leads require Sales Hub. If an entity returns no data, check that your HubSpot plan includes access to that feature.

</details>

<details>

<summary>Can I pull data from multiple HubSpot portals into one destination?</summary>

Yes. Add each portal as a separate source in the same data flow by authorizing a different HubSpot credential for each. Then use the **Append** transformation to stack all records into a single dataset. This is useful for agencies or multi-brand organizations managing separate portals.

</details>

<details>

<summary>How do I find the internal field names for custom HubSpot properties?</summary>

Internal field names are different from the display labels in HubSpot. The easiest way to find them is to run a data flow with the columns input left blank - Coupler.io will import all columns (HubSpot and custom) and the headers in your destination will show the internal names. You can also look them up in HubSpot under Settings > Properties. Review [detailed guide](https://docs.coupler.io/sources/category/crm/hubspot/best-practices/how-to-find-hubspot-columns-names) for more details.

</details>

<details>

<summary>Why are some deal stage or lifecycle stage fields showing as IDs instead of names?</summary>

This is controlled by the **Return IDs for lookups instead of labels** toggle in your data flow source settings. When enabled, lookup fields return raw IDs. Disable this option to get readable values like "Proposal Sent" or "Marketing Qualified Lead".

</details>

<details>

<summary>Can I filter Deals by pipeline or stage?</summary>

Yes, using the [**Advanced filters** section](https://docs.coupler.io/sources/category/crm/hubspot/best-practices/how-to-use-hubspot-advanced-filters). Set the property to `pipeline` or `dealstage` and enter the corresponding value. Keep in mind that HubSpot allows a maximum of 2 filters at once — if you're already using a date filter, the advanced filter will be your second and final filter slot.

</details>

<details>

<summary>Can I export HubSpot data to an AI tool like ChatGPT or Claude?</summary>

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can send your HubSpot CRM data directly to these tools for pipeline summaries, contact enrichment prompts, or automated reporting narratives.

</details>

<details>

<summary>How often can I schedule a HubSpot data flow to run?</summary>

Schedule frequency depends on your Coupler.io plan. Before scheduling, you must complete at least one successful manual run. Once confirmed, you can set the data flow to refresh automatically — hourly, daily, or at a custom interval based on your plan.

</details>

<details>

<summary>Why does my Contacts data flow take a long time to run?</summary>

Large contact databases with many custom properties can take time to process. Use the **Updated after date** filter to pull only recently modified contacts instead of the full database on every run. Also limit the columns to only the fields you need — pulling all properties on a large table significantly increases run time.

</details>

{% hint style="info" %}
For details on available fields and metrics for each entity, see the [Data Overview](https://docs.coupler.io/sources/category/crm/hubspot/data-overview) article. For connection problems or unexpected results, check [Common Issues](https://docs.coupler.io/sources/category/crm/hubspot/common-issues). For tips on structuring your data flow efficiently, see [Best Practices](https://docs.coupler.io/sources/category/crm/hubspot/best-practices).
{% endhint %}