What This Update Actually Is
HubSpot replaced the old single-form setup for Customer Agent actions with a full Actions Library. Think of it as an app store for your AI agent.
The library is searchable and filterable by category or integration. Each action has a preview so you can see how it works before you commit to it.
Here's what's now available out of the box:
- CRM: find, create, and update objects; read contact and ticket properties; find associated records
- Workflows: enroll a visitor or ticket in a HubSpot workflow
- Shopify: find an order, search products
- Commerce: find invoices, get a payment link
- Notes: create notes directly on the conversation
- Custom API: build your own action, the original flow is still available for edge cases
Alongside the library, HubSpot also shipped Action Gaps. This feature automatically analyzes your live chat and email conversations, identifies which actions your agent lacks, and recommends specific library actions to fill those holes.
Why HubSpot Shipped This
Before this update, connecting Customer Agent to your CRM or a tool like Shopify meant building and hosting API proxies. You had to map every field by hand. That's a significant technical lift, and it stopped a lot of teams from ever finishing the setup.
The internal frustration was real. Humans running portals knew the agent could theoretically look up an order or update a contact, but the configuration was complex enough that it never got done. The agent stayed generic. Resolution rates stayed low.
HubSpot's own data shows that agents with actions configured reach meaningfully higher resolution rates. The library is a direct attempt to close the gap between what Customer Agent can do and what most portals actually have set up.
Action Gaps addresses a second problem: even if you wanted to configure actions, it wasn't obvious which ones to prioritize. Now the system tells you, based on what your visitors are literally asking right now.
How to Use It Step by Step
- Go to Service, then Customer Agent, then Train, then Actions in your HubSpot portal.
- Click Add action or View all actions to open the full library.
- Browse by category or integration (CRM, Shopify, Commerce, etc.) or search by name if you know what you need.
- Preview the action: read how it works and scan the example trigger phrases so you know when the agent will call it.
- Click Continue to setup, fill in any required fields, and publish the action.
- Check the Action Gaps panel to see which actions your live conversations are already asking for. Add the recommended ones next.
Repeat the Action Gaps review weekly for the first month. Your gap list will shrink as your agent gets more capable, and you'll start to see resolution rate movement.
What It Touches in Your HubSpot Strategy
This update touches more of your portal than it might first appear. Let's walk through the ripple effects.
On the CRM side, every action that finds, creates, or updates a record is writing directly to your HubSpot data. That means your contact and ticket properties need to be clean and well-structured before you go heavy on actions. Messy properties produce messy agent behavior.
Key Takeaway
Audit your most-used contact and ticket properties before enabling CRM write actions. The agent will update what you point it at. If a field is duplicated or inconsistently labeled, you'll get inconsistent data.
The Workflow enrollment action is particularly powerful. When your agent identifies a qualifying conversation, it can drop a visitor or ticket into any existing workflow automatically. That means your nurture sequences, escalation flows, and onboarding chains all become reachable from a chat window without human intervention.
If you've already been thinking about the coaching side of Agent performance, the Action Gap coaching opportunity update we covered earlier pairs directly with this library. The gap detection is built to feed directly into the library's setup flow.
For Shopify merchants, the order lookup and product search actions mean your agent can answer transactional questions without a human rep ever touching the conversation. That's a meaningful reduction in ticket volume for e-commerce teams.
On the reporting side, once actions are live, you'll want to track resolution rate by action type. That's where your updated reporting setup becomes critical.
Key Takeaway
Set a baseline resolution rate before you activate your first action. Measure again after 30 days. That delta is the business case for every future action you configure.
If you're running Customer Agent Segments to route different audiences to different experiences, the Actions Library extends that strategy. You can configure different actions per segment context, which is covered in our write-up on Customer Agent Segments and audience personalization.
For a broader view of where HubSpot's AI agent infrastructure is heading, our pillar on the HubSpot Agentic Platform gives you the full picture. Actions are one piece of a much larger architecture HubSpot is building.
Who Should Care Most
This update matters most to a specific set of humans and company profiles.
- Service Hub admins who set up Customer Agent but never got past the basics because actions felt too technical. The library removes that blocker today.
- RevOps leaders who want to extend existing workflows into the agent layer without building net-new automation from scratch.
- E-commerce and Shopify merchants using HubSpot who field a high volume of order and product questions through chat or email.
- Marketing ops humans managing HubSpot on Marketing Hub Enterprise or Professional who want their agent to enroll contacts in nurture sequences automatically.
- Growing companies where the support team is small and deflection rate matters. Every ticket the agent resolves without a human is time back for the team.
You don't need to be a developer to benefit here. That's the point. If you can navigate the HubSpot menu and fill in a form, you can configure these actions.
George's Take
I've seen this pattern play out in portal after portal: Customer Agent gets turned on, knowledge sources get connected, and then the whole thing stalls because actions feel too hard to configure. Teams end up with an agent that's basically a fancy FAQ. That's not what this tool is built for. The Actions Library is HubSpot finally closing the gap between what the agent promises and what most portals actually deliver. And Action Gaps is the part I'm most excited about, because it stops you from having to guess. Your visitors are already telling you what they need. Now your portal listens.
“Your visitors are already telling you what actions they need. Action Gaps just makes your portal smart enough to listen.”
If you're ready to move your Customer Agent from a basic responder to a capable, action-taking part of your service operation, we can help you map the right actions, clean up the CRM data behind them, and build a measurement plan that shows real results. Book a strategy call with the Sidekick team and let's build something that actually works.
Frequently Asked Questions
What is the HubSpot Customer Agent Actions Library?
The Actions Library is a searchable catalog of pre-built actions you can add to your HubSpot Customer Agent. It includes CRM actions, Shopify order and product lookups, workflow enrollment, commerce actions, and note creation. It replaces the old manual setup process, so you don't need to build API proxies or map fields by hand.
What is Action Gaps in HubSpot Customer Agent?
Action Gaps is a feature that automatically analyzes your live chat and email conversations to identify actions your Customer Agent doesn't have configured yet. It then recommends specific actions from the library to fill those gaps, so you can prioritize based on what visitors are actually asking rather than guessing.
Which HubSpot plans include the Actions Library?
The Actions Library is available on Service Hub Professional and Enterprise, Marketing Hub Professional and Enterprise, Sales Hub Professional and Enterprise, Content Hub Professional and Enterprise, Data Hub Professional and Enterprise, and Smart CRM Professional and Enterprise. It also works with HubSpot Credits plans.
Do I need technical skills to configure Customer Agent actions?
No. The Actions Library is designed for non-developers. You browse or search the catalog, preview how each action works, click Continue to setup, fill in required fields, and publish. The original Custom API option is still there if you need a more advanced configuration, but most teams won't need it.
Can Customer Agent actions update HubSpot CRM records automatically?
Yes. CRM actions in the library let your Customer Agent find, create, and update CRM objects, read contact and ticket properties, and find associated records, all without a human rep involved. Make sure your properties are clean and consistently labeled before enabling write actions, since the agent updates whatever fields you point it at.
How does the Workflow enrollment action work in Customer Agent?
The Workflow action lets Customer Agent enroll a visitor or ticket in any existing HubSpot workflow when a qualifying conversation is detected. This means your nurture sequences, escalation flows, and onboarding chains become accessible directly from a chat or email interaction, without requiring manual handoff from a rep.
