Allow the customer agent to access and update CRM data in Hubspot
Using the customer agent in Hubspot lets your team answer questions faster by pulling in live CRM data, as long as you configure access correctly and safely.
What is the customer agent in Hubspot?
The customer agent is an AI assistant that can reference and update records in your CRM to support customer conversations. It uses permissions you define to stay within safe boundaries.
When properly set up, it can:
- Read contact, company, deal, and ticket records.
- Update field values during a conversation.
- Summarize recent activity for an account.
- Create or modify records based on customer requests.
All activity still follows your CRM permissions, so humans and automation remain in control of sensitive information.
Requirements to enable CRM data access in Hubspot
Before the customer agent can interact with your CRM, you must meet a few requirements inside Hubspot:
- Have the appropriate subscription level that includes the customer agent feature.
- Be a super admin or have permission to manage account and data settings.
- Use a supported account language and region for AI tools.
Check your subscription details in your account settings if you do not see the customer agent options described here.
How CRM permissions work with the customer agent in Hubspot
The customer agent relies on existing permission structures. It will never exceed the access granted to the user or token it runs under.
Key concepts:
- Read access: Controls which records the assistant can reference.
- Write access: Controls whether the assistant can update fields or create records.
- Object-level control: Contact, company, deal, ticket, and custom object access can all be managed separately.
Changes made by the assistant are logged like any other update, so your audit trails remain intact.
Step-by-step: enable customer agent CRM access in Hubspot
Use the following steps to allow the customer agent to access and update CRM data while preserving security.
Step 1: Open customer agent settings in Hubspot
- Sign in to your Hubspot account as a super admin.
- Click the settings icon in the main navigation bar.
- In the left sidebar, go to the customer agent or AI settings section, depending on your interface version.
- Select the workspace or inbox where you want the agent to be active.
This page controls how the assistant interacts with CRM data for that specific environment.
Step 2: Choose which CRM data the agent can read
Next, define what the customer agent is allowed to see inside Hubspot:
- Locate the option for CRM data access or similar wording.
- Enable read access for relevant objects, such as:
- Contacts
- Companies
- Deals
- Tickets
- Custom objects (if available)
- Limit access to only the objects necessary for your team’s workflows.
By restricting visibility to essential data, you reduce risk while still giving the assistant context it needs.
Step 3: Allow the agent to update CRM data in Hubspot
If you want the assistant to modify records, you must explicitly enable write access:
- In the same settings area, turn on the option that allows the agent to update CRM records.
- Specify which object types it can edit. For many teams, a safe starting point is:
- Tickets for support workflows
- Contacts for basic profile updates
- Optionally restrict the fields that can be changed, if your interface provides field-level controls.
Consider enabling updates gradually and reviewing the results before widening access to more objects or fields.
Step 4: Configure guardrails and policies in Hubspot
To keep the customer agent aligned with your processes, create clear guardrails:
- Set internal policies for what the assistant can and cannot update.
- Limit access to financial or highly sensitive properties where possible.
- Define approval workflows for high-impact updates handled by humans.
Document these policies for your team so everyone understands how the assistant should be used in daily operations.
Step 5: Test customer agent behavior with CRM data
Before rolling out widely, test the assistant in your Hubspot account:
- Create or use a sample contact, company, and ticket.
- Start a test conversation or session with the customer agent.
- Ask the agent to:
- Retrieve basic record information.
- Update a non-critical field (for example, a description or internal note).
- Check the record history to confirm the changes are logged correctly and within expectations.
Repeat testing for each object type you enabled so you fully understand how the assistant behaves.
Best practices for using CRM data with the customer agent in Hubspot
To maintain security and data quality, apply the following best practices:
Limit access to only necessary records
Grant the customer agent access only to the CRM data types it truly needs. If your workflows revolve around support, prioritize tickets and relevant contact fields and exclude unrelated objects.
Use role-based access in Hubspot
Combine the assistant configuration with role-based permissions:
- Create roles with restricted CRM access.
- Assign those roles to users responsible for managing or supervising the assistant.
- Regularly review which roles the assistant depends on and adjust based on evolving needs.
Monitor CRM updates made by the agent
Regular review helps you keep control over automated changes:
- Check record timelines for unexpected updates.
- Spot patterns of repeated manual corrections and refine access or prompts.
- Update your internal instructions if users misunderstand the limits of the assistant.
Where to learn more about customer agent settings in Hubspot
For the exact, always up-to-date configuration steps and interface details, review the official documentation for allowing the customer agent to access and update CRM data in Hubspot support resources.
If you need help designing advanced workflows or optimizing AI usage around your CRM, you can also consult specialists at Consultevo for strategic guidance.
With careful configuration, clearly defined permissions, and ongoing monitoring, the customer agent can safely work with your CRM to enhance customer experiences inside Hubspot while preserving data integrity and compliance.
Need Help With Hubspot?
If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.
“`
