How to Connect HubSpot to an AI Agent: Step-by-Step Guide

· DoubleX

Quick answer

To connect HubSpot to an AI agent, add the HubSpot connector on the Connectors screen of DoubleX Agentes, sign in to your HubSpot account, choose whether the connection is personal, team or company, pick which actions the agent may run, and test with a read-only request first.

Connecting a CRM to an AI agent is mostly a question of access: which account the agent signs in with, who can use that connection, and what the agent is allowed to change. This guide covers only the technical setup of HubSpot in DoubleX Agentes, from the connector to your first test.

What can an AI agent do in HubSpot?#

With the HubSpot connector, an agent can look up and update contacts, companies, deals and tickets in your CRM. What it actually does depends on the actions you allow, so the same connection can be read-only or able to make changes.

A connector is a system linked to the platform whose tools your agents can use. The table below shows the kinds of records involved.

HubSpot recordWhat the agent can doTypical control
ContactsLook up details, update fieldsRead-only or edit
CompaniesLook up and update recordsRead-only or edit
DealsCheck status, update dealsRead-only or edit
TicketsLook up and update ticketsRead-only or edit

For ideas on what to automate once you are connected, see what you can automate in HubSpot with an AI agent.

What do I need before connecting?#

You need a DoubleX Agentes account, an agent to use the connection, and a HubSpot login with access to the data the agent should see. Creating the account is free and requires no credit card.

Before you start, check these items:

  • A DoubleX Agentes account. If you are new, the first diagnostic is free and can turn into a team of agents with one click.
  • A HubSpot user whose permissions match what you want the agent to reach.
  • A decision on who should use the connection: only you, a team, or the whole company.
  • A rough idea of whether the agent should only read data or also change it.

How do I connect HubSpot on the Connectors screen?#

Open the Connectors screen, add HubSpot, authorize your account, and then assign the connector to an agent. After that, the agent can use HubSpot tools in its tasks.

  1. Open DoubleX Agentes and go to the Connectors screen.
  2. Find HubSpot in the list and start the connection.
  3. Sign in to your HubSpot account and authorize access when prompted.
  4. Choose the scope of the connection: personal, team or company (explained in the next section).
  5. Open the agent on the Agents screen and enable the HubSpot connector for it.
  6. Select which HubSpot actions that agent may run.
  7. Send a first request and check the result on the Tasks screen.

Credentials, tokens and keys for connections are stored encrypted with AES-256-GCM. If you prefer to manage connectors programmatically, see the Connectors API documentation.

Should the connection be personal, team or company?#

Choose personal if the connection should only work for you, team if a specific group shares it, and company if everyone should use the same CRM access. The scope decides whose HubSpot access the agent borrows.

ScopeWho it applies toWhen it fits
PersonalOnly the person who connected itTesting, or data tied to your own login
TeamMembers of a teamA sales or support group sharing one setup
CompanyThe whole companyA shared CRM connection managed by an admin

Roles also matter: DoubleX Agentes has owner, administrator and member roles, plus teams and sharing by person, team or company. Each area can have its own agents with their own instructions, systems and permissions.

How do I limit the agent to read-only or allow changes?#

For each agent, you choose which systems it uses and, inside each system, which actions it can run. To keep HubSpot read-only, leave the actions that change data turned off.

A sensible rollout looks like this:

  1. Start with read actions only, such as looking up contacts, companies, deals and tickets.
  2. Run a few real requests and review the results in the task history.
  3. Turn on update actions only for the agent that needs them.
  4. Keep confirmation in mind: before sending, deleting or changing something in your systems, the agent asks for confirmation and shows the step-by-step of what it did.

This way you can give a reporting agent read-only access while a separate agent has permission to update records. If you want ready-made prompts for either setup, browse HubSpot AI agent request examples.

How do I test with a first request and check the task history?#

Send a simple read-only request, then open the task on the Tasks screen. Each request becomes a task with the full history: the request, every tool the agent used and the result.

Try one of these first requests:

  • "Find the contact with the email [email protected] in HubSpot and show me her company and open deals."
  • "List the deals in HubSpot that are still open and show their current stage."
  • "Show the open tickets for the company Acme and summarize each one."
  • "Look up the company Northwind in HubSpot and list its contacts."

Then verify the setup:

  1. Open the task on the Tasks screen.
  2. Confirm the agent called HubSpot tools and not something else.
  3. Check that the data matches what you see in HubSpot.
  4. Try an update request. If edit actions are off, the agent should not change anything.

Once the basics work, you can schedule recurring work. See HubSpot AI agent routines and tool combinations for next steps.

Frequently asked questions#

Do I need to code to connect HubSpot?#

No. You add the connector on the Connectors screen and describe what you need in your own words. If you want to go further, DoubleX Agentes also offers a REST API, a command line (CLI) and an MCP server.

Can the agent change my HubSpot data without asking?#

Only if you allow it. You choose the actions per agent, and changes can stay off for read-only use. Before sending, deleting or changing anything, the agent asks for confirmation.

Is my HubSpot data used to train AI models?#

No. Company content is not used to train models, and requests only go to AI providers that do not use what they receive for training. Each company also has its own separate database.

Can I see what the agent did in HubSpot?#

Yes. Every request becomes a task with a complete history: the request, each tool used and the result. You can see who asked, what was done and when.

Can several people share one HubSpot connection?#

Yes. A connection can be personal, for a team or for the whole company, and you control access with roles, teams and sharing.

Related guides

More HubSpot guides