HubSpot API: what you can do and how to use it with AI agents
The HubSpot API gives access to CRM objects such as contacts, companies, deals and tickets, and also to marketing, conversations and custom properties. Sales teams, RevOps and integrators use it. Access is open through a private app with a token or a public app with OAuth, and which features are available depends on the plan.
What the HubSpot API offers
CRM objects
Contacts, companies, deals, tickets, products and custom objects.
Associations
Links between objects, such as a contact with a company and a deal.
Engagements
Notes, tasks, e-mails, calls and meetings logged on the timeline.
Pipelines
Deal and ticket stages and moving records between them.
Properties
Standard and custom fields of each object.
Search
Filtered queries across CRM objects.
Webhooks
Notices of record creation and changes for apps.
How to access the HubSpot API
- Public APIA private app with an access token and scopes chosen in the account, or a public app with OAuth 2.0. Old API keys have been discontinued.
- Request limits vary by plan: use search and batches instead of single calls.
- Choose minimum scopes in the private app.
- Contacts have a legal basis and consent: respect communication preferences (GDPR and similar laws).
Official documentation: developers.hubspot.com
What an iTeam agent does with the HubSpot API
Deal stalled at a stage
The agent finds deals with no activity for two weeks and sends the rep a summary of the last contact with a suggested next step.
Effortless meeting logging
After the call, the agent creates the note on the deal, updates properties such as budget and timeline, and schedules the follow-up task.
Ticket with context
When a ticket is opened, the agent associates the company and contract and summarizes the latest interactions for support.
A clean database
The agent identifies duplicate contacts and companies with no domain and proposes bulk fixes for approval.
From the credential to the agent at work, with approval
Create a private app in HubSpot
A super admin sets the minimum scopes, for example read and write for deals and contacts.
Register the token in the iTeam vault
The token stays in the vault and each agent has its own permissions. The SDR agent does not change pipelines.
Test with approval
Notes and tasks can be automatic. Stage changes, merges and deletions go through approval.
Ready-made AI teams that use HubSpot
WhatsApp customer service
Customers write at 11 p.m. and on Sundays. This team replies in seconds, with your prices and policies, and calls a person when it should.
AI phone receptionist
It answers the phone, books the visit in your calendar and sends your team a short note about every call.
Customer success team
It reads usage, tickets and CRM notes every week and tells your team which accounts need a call, and why.
Outbound prospecting team
It finds the accounts that fit, reads what they are doing right now and writes a first message that sounds like it came from a person.
Lead qualification team
Every form, ad and WhatsApp lead gets a quick reply, a few good questions and, if it fits, a meeting on your seller's calendar.
WhatsApp sales team
It answers product questions, puts the quote together and follows up with the buyer who said "let me think about it".
Questions about the HubSpot API
Is the HubSpot API free?
Generally, the API is available even on the free plan, but some objects and limits depend on paid plans.
Do I need to code to use the HubSpot API with iTeam?
Not necessarily. HubSpot has a ready-made connector in the catalog, and the deployment team sets up the flows.
Can I use custom properties?
Yes, the API reads and writes custom properties just like the standard ones.
