Skip to main content

​
Overview

OneCLI connects AI agents to HubSpot through OAuth. Agents can read and manage CRM records including contacts, companies, deals, and tickets. The gateway injects OAuth credentials into requests to the HubSpot API automatically.
HubSpot is a cloud-only integration, available on the Team plan.

​
Setup

1

Go to Connections

Open the OneCLI dashboard and navigate to Connections > HubSpot.
2

Authorize

Click Connect HubSpot. You’ll be redirected to HubSpot to authorize OneCLI. Review the requested permissions and click Grant access.OneCLI requests read access to contacts, companies, deals, owners, and tickets by default. Write access and additional scopes (line items, quotes, lists, schemas) are optional.
3

Verify

After authorization, you’ll be redirected back to the dashboard. The connection will show as Connected with your HubSpot portal domain.

​
What agents can do

​
Use cases

  • CRM enrichment agents that update contact records with data from other sources
  • Sales pipeline agents that track deals and update stages
  • Support agents that create and triage tickets
  • Reporting agents that pull CRM data for analysis

​
Controlling access

Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization rules add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches the HubSpot API.