# Agents inside your HubSpot portal

> AI agents for HubSpot: lead qualification, ticket triage and deal hygiene on the CRM API, started by workflows and webhooks, with writes held for a person.

Canonical page: https://aispeedforce.com/platforms/hubspot/

Last updated: 2026-09-23

HubSpot's CRM API gives an agent contacts, companies, deals and tickets, and workflows give it a trigger. We build the agent as a private app scoped to the objects its task needs, and hold anything customer-facing for a person.

## Three agents that keep the CRM honest

Each one does a single job on the CRM API. Reads are broad enough to understand the record; writes are narrow and held.

### Lead qualification

Reads a new contact and its company, scores it against your criteria, sets lifecycle properties and assigns an owner.

- **Touches**: contacts, companies, associations, owners
- **Human gate**: Owner changes and anything sent to the lead.

### Ticket triage

Reads new tickets with their history, sets category and priority, and drafts a reply for the person handling it.

- **Touches**: tickets, associations, notes
- **Human gate**: Every reply to a customer.

### Deal hygiene

Finds deals with missing amounts, stale stages or no next step, and prepares the updates and follow-up tasks.

- **Touches**: deals, tasks, associations
- **Human gate**: Stage changes and amount changes.

## What it connects to

Five surfaces, all public HubSpot APIs. The agent runs as a private app, so its access is limited to the scopes you approve.

- **CRM API**: Contacts, companies, deals and tickets, read and updated through one tool per object and operation.
- **Associations**: How the agent sees that a ticket belongs to a contact and a contact to a company, so it reads the whole picture.
- **Workflows**: A workflow can start an agent run, so your team triggers work from the automation tool they already use.
- **Webhooks**: Object events such as a new contact or a changed deal start a run without polling.
- **Tasks**: The gate. A held action becomes a task on the record, assigned to the person who approves it.

### What each agent reads and writes

Read access is broad enough to answer the question, write access is narrow, and every write has a gate until you decide otherwise.

| Agent | Reads | Writes | Human gate |
|---|---|---|---|
| Lead qualification | `contacts`, `companies` | Lifecycle properties, owner | Owner changes, outreach |
| Ticket triage | `tickets`, history | Category, priority, drafted reply | Every customer reply |
| Deal hygiene | `deals`, activity | Properties, `tasks` | Stage and amount changes |

## Approvals arrive as HubSpot tasks

A held action becomes a task on the record it would change. The owner sees it in their task queue, with the draft and the trace linked.

**Where it sits**: In HubSpot's own task queue, on the contact, ticket or deal the agent wants to change. No second tool to log into.

**What a reviewer sees**: The proposed change in full, the record it targets, and a link to the run trace behind it.

**What waits by default**: Anything sent to a customer, owner changes, and deal stage or amount changes. Property clean-up on internal fields can run once you allow it.

**What a rejection does**: The run stops, the rejection is kept with its trace, and it goes into the eval suite so the agent is tested against it on every change.

## Questions HubSpot teams ask first

### Do we need a particular HubSpot hub or tier?

It depends on the objects the task needs. Tickets need Service Hub and some workflow triggers need higher tiers, so we check your portal before we scope the build.

### Is this a public HubSpot app?

No. For one company it is a private app in your own portal, holding only the scopes the agent's tasks need. You can revoke it at any time.

### Can the agent send emails from HubSpot?

It drafts them. Sending stays with a person by default, because outbound email is the action most likely to cause real harm.

### Where to go next

- [Agent engineering](https://aispeedforce.com/services/agent-engineering/)
- [Automation and workflows](https://aispeedforce.com/services/automation-workflows/)
- [Salesforce agents](https://aispeedforce.com/platforms/salesforce/)
- [All platforms](https://aispeedforce.com/platforms/)
- [Contact](https://aispeedforce.com/contact/)

## Name one job in your HubSpot portal

Tell us the lead, ticket or deal task your team repeats every day. We will tell you which objects the agent would read, what it would write, and where the task-based gate sits.