# HubSpot AI connector guide

Connect HubSpot data to AI agents with Combined. Explore contacts, companies, deals, source setup, MCP access and read-only business queries.

Combined offers 1,125 connectors across catalog sources and connectors generated through desktop automation.

## Connect

1. Open Combined Connected Apps and select HubSpot.
2. Authorize the source and choose the relevant datasets.
3. Complete a first sync, then grant your agent access through the Set up or Access workspace.
4. Discover the actual source schemas before querying.

## Setup reference

- Association Between Objects Streams: optional
- From Object: depends on the selected authentication/setup option
- Stream Name: depends on the selected authentication/setup option
- To Object: depends on the selected authentication/setup option
- Authentication: required in the upstream source schema; OAuth or Private App
- Client ID: depends on the selected authentication/setup option
- Client Secret: depends on the selected authentication/setup option
- Refresh Token: depends on the selected authentication/setup option
- Access token: depends on the selected authentication/setup option
- Custom Object Association Streams: optional
- From Object: depends on the selected authentication/setup option
- Stream Name: depends on the selected authentication/setup option
- To Object: depends on the selected authentication/setup option
- Enable experimental streams: optional
- CRM Search Lookback Window (minutes): optional
- Number of concurrent threads: optional
- Property History Lookback Window (minutes): optional
- Start date: optional
- Treat dynamic number and boolean properties as strings: optional

## Dataset reference

- contacts; key: id; update field: updatedAt
- companies; key: id; update field: updatedAt
- deals; key: id; update field: updatedAt
- campaigns; key: id; update field: lastUpdatedTime
- companies_property_history; key: companyId, property, timestamp; update field: timestamp
- contact_lists; key: listId; update field: updatedAt
- list_memberships; key: recordId, listId
- contacts_property_history; key: vid, property, timestamp; update field: timestamp
- deal_pipelines; key: pipelineId; update field: updatedAt
- deal_splits; key: id; update field: updatedAt
- deals_archived; key: id; update field: archivedAt
- deals_property_history; key: dealId, property, timestamp; update field: timestamp
- email_events; key: id; update field: created
- email_subscriptions; key: id
- engagements; key: id; update field: lastUpdated
- engagements_calls; key: id; update field: updatedAt
- engagements_emails; key: id; update field: updatedAt
- engagements_meetings; key: id; update field: updatedAt
- engagements_notes; key: id; update field: updatedAt
- engagements_tasks; key: id; update field: updatedAt
- form_submissions; update field: updatedAt
- forms; key: id; update field: updatedAt
- goals; key: id; update field: updatedAt
- leads; key: id; update field: updatedAt
- line_items; key: id; update field: updatedAt
- marketing_emails; key: id; update field: updatedAt
- owners_archived; key: id; update field: updatedAt
- owners; key: id; update field: updatedAt
- users; key: id
- products; key: id; update field: updatedAt
- subscription_changes; update field: timestamp
- ticket_pipelines; key: id; update field: updatedAt
- tickets; key: id; update field: updatedAt
- workflows; key: id; update field: updatedAt
- properties
- account_details

This is the upstream connector reference, version 6.8.0. Account permissions and sync configuration determine the datasets available in your workspace.

## Agent prompt

Use Combined to analyze my HubSpot data.
List my granted sources, discover the datasets and describe their fields.
Look for datasets corresponding to contacts, companies, deals, campaigns, companies_property_history, contact_lists.
Check the last successful sync and report the available date coverage.
Propose three useful questions based on the fields actually available.
For the question I choose, run read-only SQL over the complete matching dataset.
Use a bounded result; include source names, time window and query receipt.
Ask for a missing join key or metric definition instead of inventing one.

## Links

- Combined: https://www.trycombined.com/
- Setup: https://www.trycombined.com/docs/getting-started/onboarding
- MCP: https://www.trycombined.com/docs/integrations/mcp
- Pricing: https://www.trycombined.com/pricing
- Upstream source reference: https://docs.airbyte.com/integrations/sources/hubspot
- Full guide: https://www.trycombined.com/connectors/hubspot