HubSpot API for AI Agents

CRM, marketing, and sales platform

HubSpot provides APIs for managing contacts, deals, companies, tickets, and marketing automation. AI agents can use HubSpot to automate CRM workflows, manage leads, send marketing emails, and track customer interactions.

What AI agents can do with HubSpot

Structured actions an AI agent can execute through the HubSpot API

Action

Description

Inputs

Outputs

createContact

Create a new contact

email, firstname, lastname, phone, company

contact_id, properties

createDeal

Create a new deal

dealname, amount, pipeline, dealstage, associated_contacts

deal_id, properties

searchContacts

Search contacts by criteria

filters, sorts, limit, properties

results[], total, paging

createTicket

Create a support ticket

subject, content, pipeline, hs_ticket_priority

ticket_id, properties

Use cases for HubSpot + AI agents

Lead management and scoring automation
Deal pipeline management
Customer support ticket creation
Marketing email automation
Contact enrichment and deduplication

How to connect HubSpot to an AI agent

1Get your HubSpot private app access token
2Generate an AgentSpec for CRM actions
3Define contact, deal, and ticket actions
4Publish for discovery
5Map your CRM properties to action schemas

Best practices

✓Use private app tokens instead of API keys for better security

✓Include reasoning docs about deal stages and pipeline logic

✓Handle association objects properly (contact → company → deal)

✓Use search with filters instead of listing all records

✓Implement deduplication checks before creating contacts

Frequently asked questions

Can AI agents manage HubSpot CRM?+

Yes. Agents create and update contacts, deals, tickets, and companies through structured actions. This enables automated lead management, deal tracking, and customer support.

How do agents handle HubSpot associations?+

Use the associations API to link contacts to companies and deals. Define association actions in your spec so agents can maintain relationship graphs.

What HubSpot scopes do agents need?+

crm.objects.contacts.read/write, crm.objects.deals.read/write, crm.objects.tickets.read/write at minimum. Add scopes based on which CRM objects the agent manages.