HubSpot
Your AI-powered CRM assistant
The Complete OpenClaw HubSpot Integration Guide
HubSpot is the leading CRM and marketing automation platform for growing companies, trusted by over 200,000 businesses worldwide. With OpenClaw's HubSpot integration, your AI assistant becomes a powerful extension of your sales and marketing stack — answering CRM queries, updating deals, logging activities, and triggering automation workflows through simple conversation.
Why Integrate OpenClaw with HubSpot?
Modern sales and marketing professionals spend hours each day navigating between tabs, updating records, and managing their pipeline. The OpenClaw HubSpot integration eliminates this friction entirely. Instead of clicking through menus and filling forms, just tell your assistant what you need:
- "Look up the contact info for Sarah at TechCorp"
- "Update the Acme deal to Proposal Sent"
- "Log my call with Mike about the enterprise renewal"
- "Add this lead to the Product Launch nurture sequence"
Your assistant handles the HubSpot API calls behind the scenes while you focus on what matters — building relationships and closing deals.
Perfect for Growing Companies
This integration is designed for marketing and sales professionals at companies in growth mode. Whether you're a startup scaling your first sales team or a mid-market company optimizing your go-to-market motion, OpenClaw + HubSpot helps you:
- Move faster: No context-switching between your chat app and HubSpot
- Stay organized: Log activities in real-time as they happen
- Never lose context: Get instant briefings before any call or meeting
- Scale intelligently: Trigger automations and workflows conversationally
HubSpot Hubs Supported
OpenClaw integrates across the full HubSpot platform:
- CRM: Contacts, Companies, Deals, Tasks, Notes
- Marketing Hub: Email campaigns, Forms, Landing pages, Workflows
- Sales Hub: Pipeline management, Sequences, Meeting scheduling
- Service Hub: Tickets, Knowledge base queries
- Operations Hub: Custom workflows, Data sync
Enterprise-Ready Features
For larger organizations on HubSpot Enterprise, OpenClaw supports:
- Custom objects: Access any custom object you've created in HubSpot
- Calculated properties: Read computed fields and rollup values
- Advanced permissions: Respects HubSpot's team and user permissions
- Multi-portal support: Connect multiple HubSpot accounts if needed
- Audit logging: Track all AI-initiated actions for compliance
How the Integration Works
The OpenClaw HubSpot integration uses HubSpot's official REST API with OAuth 2.0 authentication:
- You create a Private App in your HubSpot account with the necessary scopes
- OpenClaw connects using your access token, securely stored in your config
- Natural language queries are translated into HubSpot API calls
- Results are returned as conversational responses with relevant details
All processing happens on your infrastructure. Your HubSpot data never passes through third-party services beyond the AI model you've configured.
Getting Started
Setup takes about 15-25 minutes and requires no coding. You'll need:
- A HubSpot account (Free CRM or any paid tier)
- Super Admin or App Marketplace Access permissions
- OpenClaw installed and running
Follow the step-by-step setup guide below to connect your AI assistant to HubSpot and start working smarter.
Features
Contact & Company Lookup
Instantly find any contact or company in your CRM. Ask 'Who's our main contact at Acme Corp?' or 'Show me all contacts at companies in the Bay Area' and get immediate, detailed results.
Deal Pipeline Management
Track opportunities through your sales pipeline. Check deal stages, update amounts, move deals forward, and get pipeline summaries — all conversationally.
Activity Logging
Log calls, emails, meetings, and notes without touching HubSpot. Say 'Log a call with Jennifer about the Q2 renewal — she's interested but needs budget approval' and it's recorded with full context.
Email Integration
Log sent emails to contact records, check email engagement (opens, clicks), and trigger email sequences. 'Add Michael to the Demo Follow-up sequence' enrolls them instantly.
Marketing Automation Triggers
Trigger HubSpot workflows and sequences through conversation. Enroll contacts in nurture campaigns, update lead scoring, and activate automations without navigating the workflow editor.
Meeting Scheduling
Check your HubSpot meeting link availability and share booking links. 'Send Tom my calendar link for a 30-minute call' generates the right meeting URL.
Smart CRM Search
Search across contacts, companies, deals, and tickets with natural queries. 'Find all deals over $50k closing this quarter' or 'Show me contacts who opened our last email campaign'.
Task Management
Create, complete, and manage HubSpot tasks. 'Remind me to follow up with Sarah on Friday' creates a task associated with the right contact.
Enterprise Custom Objects
For HubSpot Enterprise customers: full access to custom objects you've defined. Query, create, and update records in your bespoke data structures.
Real-time Property Updates
Update any standard or custom property on contacts, companies, or deals. 'Set Acme's lifecycle stage to Customer' or 'Update the contract value to $75,000'.
Use Cases
Pre-Call Research
Before any sales call, ask 'Brief me on TechStart Inc' and get company details, recent activities, open deals, key contacts, and last touch points in seconds.
Real-Time Activity Logging
Log activities immediately after calls and meetings. While the conversation is fresh, capture notes, next steps, and outcomes without the friction of opening HubSpot.
Pipeline Reviews
Get instant pipeline snapshots for standups and forecasting. 'Show me deals closing this month' or 'What's our total pipeline value in the negotiation stage?'
Marketing Campaign Enrollment
Quickly enroll leads into nurture sequences and campaigns. 'Add everyone from yesterday's webinar to the Product Demo nurture' handles batch operations conversationally.
Lead Qualification
Look up new inbound leads, check if they're already in your CRM, and update lead scoring. Qualify leads faster with instant access to company and contact intelligence.
End-of-Day CRM Hygiene
Batch update your activities before logging off. 'Log calls with John, Maria, and Steve about contract discussions' captures everything efficiently.
Deal Stage Updates
Keep your pipeline current by updating deals as conversations progress. 'Move the Zenith deal to Proposal Sent and add a note about the security requirements they mentioned.'
Cross-Functional Handoffs
When passing leads from marketing to sales or customers to success, quickly pull context and add transition notes without switching tools.
Setup Guide
Requirements
- ✓HubSpot account (Free CRM, Starter, Professional, or Enterprise)
- ✓Super Admin permissions OR App Marketplace Access
- ✓OpenClaw installed on macOS or a Linux server
- ✓For advanced features: Marketing Hub Professional or Sales Hub Professional
Create a HubSpot Private App
In HubSpot, go to Settings → Integrations → Private Apps. Click 'Create a private app'. Name it 'OpenClaw Integration' or similar. This is more secure than using full OAuth for personal integrations.
Configure Scopes
In the Private App setup, go to the Scopes tab. Enable the scopes you need: **Essential:** crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.companies.read, crm.objects.companies.write, crm.objects.deals.read, crm.objects.deals.write **For full features:** sales-email-read, crm.objects.owners.read, automation, tickets **Enterprise:** crm.schemas.custom.read, crm.objects.custom.read, crm.objects.custom.write
Generate Access Token
After configuring scopes, click 'Create app'. HubSpot will show your access token once. Copy it immediately and store it securely — you won't be able to see it again (though you can create a new one).
Configure OpenClaw
Add the HubSpot configuration to your OpenClaw config file (~/.config/openclaw/config.yaml or your custom location). Include your access token and optional settings.
Test the Connection
Start or restart OpenClaw with 'openclaw gateway restart'. Test by asking your assistant 'How many contacts are in my HubSpot?' or 'Look up [a contact you know exists]'.
Optional: Configure Advanced Features
For Enterprise features like custom objects, add the custom object names to your config so OpenClaw knows about your data model. For workflow triggers, ensure the workflows you want to trigger are active.
Configuration Example
hubspot:
accessToken: "pat-na1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
# Optional: Restrict which objects the assistant can access
enabledObjects:
- contacts
- companies
- deals
- tasks
- notes
# Optional: Enable marketing features (requires Marketing Hub)
marketing:
enabled: true
allowWorkflowTriggers: true
# Optional: Enterprise custom objects
customObjects:
- name: "projects"
displayName: "Projects"
- name: "subscriptions"
displayName: "Subscriptions"
# Optional: Default settings
defaults:
pipelineId: "default" # For deal creation
ownerId: "12345678" # Default owner for new recordsLimitations
- ⚠️Some features require specific HubSpot Hub subscriptions (e.g., Sequences require Sales Hub)
- ⚠️Custom objects require HubSpot Enterprise
- ⚠️API rate limits apply (100 calls/10 seconds for Free/Starter, higher for paid tiers)
- ⚠️Workflow triggering limited to published, active workflows
Frequently Asked Questions
Does this work with HubSpot Free CRM?
Yes! The core CRM features — contacts, companies, deals, tasks, and notes — work with HubSpot's free tier. Advanced features like sequences, workflows, and custom objects require paid HubSpot subscriptions.
What's the difference between Private Apps and OAuth?
Private Apps are simpler for personal/team integrations — you get an access token directly without building an OAuth flow. OAuth is better for public apps serving multiple HubSpot accounts. For OpenClaw, Private Apps are recommended.
How does this compare to HubSpot's AI features?
HubSpot has built-in AI features (ChatSpot, AI assistants). OpenClaw gives you a self-hosted alternative with full control over the AI model, deeper integrations with other tools, and the ability to combine HubSpot with your other systems in one assistant.
Are there API rate limits?
Yes. Free/Starter accounts: 100 requests per 10 seconds. Professional: 150/10s. Enterprise: 200/10s. Plus daily limits based on your tier. Normal conversational usage rarely hits these limits.
Can multiple team members use this?
The Private App token gives access based on the scopes you selected. For team use, you can either share the OpenClaw instance (each user identified by their messaging platform ID) or create separate Private Apps per user for individual access control.
Does it work with EU data residency (HubSpot EU)?
Yes. OpenClaw connects to whatever HubSpot instance your account uses. EU-hosted HubSpot portals work the same way — just use the access token from your EU portal.
Can I trigger HubSpot workflows?
Yes, if you have Marketing Hub or Sales Hub Professional/Enterprise. You can enroll contacts in workflows, trigger specific workflow actions, and add contacts to sequences. The workflows must be active (published) in HubSpot.
What about custom properties?
Full support for custom properties on all objects. Ask 'What's the NPS score for Acme Corp?' if you have a custom NPS Score property. You can read and update any custom property your Private App has scope to access.
Is my HubSpot data secure?
OpenClaw runs on infrastructure you control. Data is accessed via HubSpot's official API using your Private App token. No data passes through third-party services except the AI model you configure. Revoke the token anytime in HubSpot settings.
Can it handle HubSpot Associations?
Yes. When you look up a contact, you'll see associated companies and deals. When updating records, you can specify associations. 'Create a deal for Acme Corp' automatically associates with the right company.
What happens if my HubSpot subscription changes?
Features gracefully degrade based on your subscription. If you downgrade from Enterprise, custom objects become unavailable but standard CRM features continue working. OpenClaw will surface clear errors for unavailable features.
Can I use this with HubSpot Sandbox?
Yes. Create a Private App in your sandbox portal and use that access token. Great for testing before deploying to your production HubSpot account.
🔥 Your AI should run your business, not just answer questions.
We'll show you how.$97/mo (going to $197 soon)
Related Integrations
📚 Learn More
OpenClaw Installation Guide — All Platforms (Linux, macOS, Unraid)
Complete installation guide covering gateway setup, Ollama integration, systemd services, and troubleshooting common setup errors like ECONNREFUSED and model loading issues.
How to Connect Gmail to Your AI Assistant (Complete Integration Guide)
Turn Gmail into an AI-powered inbox. Summarize threads, draft replies, auto-categorize messages, and search your email with natural language.
OpenClaw on Windows — Installation & Common Issues
Step-by-step Windows installation guide covering Node.js setup, WSL2 configuration, LM Studio integration, and troubleshooting Windows-specific issues.
Discord Bot Setup — OpenClaw Integration Guide
Complete guide to setting up Discord as a channel for OpenClaw. Covers bot creation, permissions, authorization errors, slash commands, duplicate messages, per-channel configuration, and credential storage.
🐙 Your AI should run your business.
Weekly live builds + template vault. We'll show you how to make AI actually work.$97/mo (going to $197 soon)
Join Vibe Combinator →