FAQ

Which HubSpot plan do I need to use Coupler.io?

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.

Can I pull data from multiple HubSpot portals into one destination?

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.

How do I find the internal field names for custom HubSpot properties?

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 custom fields input left blank — Coupler.io will import all custom fields and the column headers in your destination will show the internal names. You can also look them up in HubSpot under Settings > Properties.

Why are some deal stage or lifecycle stage fields showing as IDs instead of names?

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".

Can I filter Deals by pipeline or stage?

Yes, using the Advanced filters section. 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.

Can I export HubSpot data to an AI tool like ChatGPT or Claude?

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.

How often can I schedule a HubSpot data flow to run?

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.

Why does my Contacts data flow take a long time to run?

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.

For details on available fields and metrics for each entity, see the Data Overview article. For connection problems or unexpected results, check Common Issues. For tips on structuring your data flow efficiently, see Best Practices.