How to get your HubSpot data ready for agentic AI
Sync HubSpot contacts, deals, engagements, and associations with Airbyte, then give AI agents read-only CRM access through the Airbyte MCP.

Airbyte syncs HubSpot CRM objects, engagements, and associations into your warehouse, and the Airbyte context layer lets agents read and search HubSpot records directly through the Airbyte MCP.
A CRM is where agents can save sales and support teams the most time. Prep for a renewal call, summarize every touchpoint with an account, find deals that have gone quiet: these are tasks people do by clicking through record after record. HubSpot holds the data for all of them, spread across contacts, companies, deals, tickets, and the engagements that connect them.
Agents need two kinds of access to that data. For analysis across many records, a governed warehouse copy is more reliable and cheaper to query than the HubSpot API. For a quick lookup of one record's current state, direct read-only access is faster than waiting for a sync. Airbyte provides both.
Why HubSpot data matters for agentic AI
HubSpot data is relational and conversational at once:
- CRM objects. Contacts, companies, deals, tickets, line items, products, and custom objects describe who your customers are and what they are buying.
- Engagements. Calls, emails, meetings, notes, and tasks hold the text of the relationship, which is exactly what language models are good at summarizing.
- Associations. Links between objects tell an agent which contacts belong to which company and which tickets relate to which deal.
- Marketing signals. Forms, form submissions, email events, and subscription changes show engagement before a sale.
What agents can do with HubSpot data
- Prepare account briefs. Pull a company's contacts, open deals, recent tickets, and the last few engagements into one summary before a call.
- Flag stalled deals. Use deal stages and property history to find deals that have not moved in a set period, then check engagements for the last real touch.
- Summarize support context. Search notes and tickets for themes across an account, such as repeated complaints about one feature.
- Clean up CRM data. Find contacts without associated companies, or duplicate companies, using association streams in the warehouse.
- Track pipeline changes over time. With property history streams, report how deal amounts or stages changed week over week.
How Airbyte gets HubSpot data ready
Authentication
- OAuth is recommended and refreshes access tokens automatically.
- Private App access tokens are static tokens with per-object scopes. HubSpot is retiring the creation of new Private Apps during 2026; existing apps and tokens keep working.
- Service Keys (HubSpot public beta) are an option for accounts that cannot create a Private App. They use the same field and scopes as a Private App token.
For Private Apps and Service Keys, you grant scopes per stream. The connector docs list the scope each stream needs.
Streams
The connector covers CRM objects, engagements, and marketing data, including:
- Companies, Contacts, Contact Lists, Deals, Deal Pipelines, Deal Splits, Tickets, Line Items, Products, Owners, Goals, Leads
- Engagements, plus separate streams for calls, emails, meetings, notes, and tasks
- Email Events, Forms, Form Submissions, Marketing Emails, Subscription Changes, Campaigns
- Property history streams for contacts, companies, and deals
- Workflows, plus a Flows stream and web analytics streams behind the experimental streams toggle
- Custom objects
Associations
Association streams sync relationships between two standard CRM objects. You add one per pair, such as tickets to companies, and each record includes from_id, to_id, association_type_id, category, and label. Custom object association streams do the same when one side is a custom object. Association streams use full refresh.
Sync modes and freshness
HubSpot supports Full Refresh and Incremental. Some streams use server-side incremental, where HubSpot returns only changed records. Others use client-side incremental, where the connector filters records itself.
Two settings help keep the copy complete:
- CRM Search Lookback Window re-fetches a number of minutes before the last saved state for CRM search streams such as contacts, companies, deals, and tickets.
- Property History Lookback Window does the same for property history streams, to handle cursor drift from calculated properties. The docs suggest 43200 minutes (30 days) as a starting point.
Deletes and limits
- Deleted deals are available through the Deals Archived stream. HubSpot keeps recycle bin records for 90 days.
- Engagements can be slow to sync if the stream has not synced in the last 30 days or has a large backlog, so schedule frequent syncs.
- Rate limits. HubSpot applies burst limits per app and a daily limit shared across the account, so other integrations draw from the same daily budget.
How agents reach HubSpot data
HubSpot is an agent connector in Airbyte Cloud, so it works with both parts of the context layer:
- Agent access (direct reads). Agents can list and get contacts, companies, deals, tickets, notes, calls, emails, meetings, tasks, schemas, objects, and associations, and use HubSpot's own search on contacts, companies, deals, and tickets. Direct reads use the credentials stored in Airbyte, so the agent never sees them. They are read-only and count toward HubSpot rate limits.
- Search. When a connection syncs HubSpot to an agent-connector destination, Airbyte can index the selected streams. The open-source Airbyte agent SDK lists semantic search for tickets and the engagement types (notes, calls, emails, meetings, tasks), which suits free-text questions like "which customers mentioned onboarding problems."
Agents connect through the hosted Airbyte MCP at https://mcp.airbyte.com/mcp. Direct reads and searches are free up to 100,000 combined per organization per month.
A governance point from the MCP docs: direct reads use the connector's stored HubSpot credentials, not each user's own. An Airbyte user could therefore see HubSpot records through an agent that their own HubSpot permissions would hide. Scope the connected account accordingly.
What this unlocks
- Account briefs that combine records, associations, and engagement text.
- Analysis over deal and property history from the warehouse.
- Quick, read-only lookups of current CRM state.
- Semantic search over notes and tickets.
- Less pressure on HubSpot's shared daily API limit.
Getting started
- Create a HubSpot source in Airbyte Cloud and authenticate with OAuth.
- Select CRM and engagement streams and add the association streams you need.
- Sync to BigQuery or Snowflake with incremental syncs.
- Turn on agent access and search, then connect your agent to the Airbyte MCP.
Try Airbyte free or talk to sales about CRM data for agents.
Frequently asked questions
How do I authenticate the HubSpot connector?
OAuth is the recommended method and refreshes tokens automatically. You can also use a Private App access token. HubSpot is retiring creation of new Private Apps in 2026, so accounts that cannot create one can use a HubSpot Service Key, which is in public beta, in the same field.
Does Airbyte sync deleted HubSpot deals?
The Deals Archived stream syncs deals that were deleted and moved to HubSpot's recycle bin. HubSpot only keeps recycle bin records for 90 days, so sync at least that often if deleted deals matter to your agents.
How do I sync relationships between HubSpot objects?
Configure association streams in the connector. Each one pairs a from object and a to object, such as tickets and companies, and emits from_id, to_id, association type, category, and label. Custom object association streams cover relationships that involve custom objects.
Can an agent update HubSpot records through the Airbyte context layer?
No. Direct reads and searches through the context layer are read-only. Agents can list, get, and search records, but cannot create, update, or delete them through these tools.
Why might engagement streams sync slowly?
The engagements stream uses HubSpot's recent engagements API only when the last sync was within 30 days and fewer than 10,000 records are pending. Otherwise it reads all engagements, which is slower, so Airbyte recommends scheduling frequent syncs.
Integrate with 700+ apps using Airbyte
Move data from 700+ sources into warehouses, lakes, and beyond. Set up pipelines in minutes with pre-built connectors and the Connector Builder.
