HubSpot
Enable your AI agent to get contact information, check deal status, create new contacts, and update records in HubSpot CRM.
5 min read
Updated February 2026
Overview
The HubSpot integration connects your AI agent to your HubSpot CRM. Your chatbot can look up contacts, check deal pipelines, create new contact records, and update existing data through natural conversation.
Perfect for sales and marketing teams using HubSpot who want to capture leads and provide account information through chat.
Available Actions
| Action | Description |
|---|---|
| Get Contact | Look up contact information by email |
| Get Deal | Check the status of a deal in your pipeline |
| Create Contact | Create a new contact record from chat conversation |
| Update Contact | Update existing contact properties |
Prerequisites
Before setting up the HubSpot integration, you'll need:
- A HubSpot account (Free CRM or any paid plan)
- Admin access to create private apps
Setup Instructions
Step 1: Create a Private App
- Log in to your HubSpot account
- Go to Settings (gear icon)
- Navigate to Integrations → Private Apps
- Click Create a private app
- Name it “ChatSpark Integration”
Step 2: Configure Scopes
- Go to the Scopes tab
- Add the following scopes:
crm.objects.contacts.readcrm.objects.contacts.writecrm.objects.deals.read
- Click Create app
Step 3: Get Your Access Token
- After creating the app, copy the Access token
- Keep this token secure. It provides access to your HubSpot data
Step 4: Enable in ChatSpark
- In ChatSpark, go to AI Actions
- Find HubSpot in the Library and click Enable
- Select the chatbot(s) that should have access
- Enter your Access Token
- Click Save
Configuration Fields
| Field | Description | Example |
|---|---|---|
| Access Token | Your HubSpot private app access token | pat-na1-xxxxx... |
Testing Your Integration
After setup, test the integration:
- Open your chatbot widget
- Try asking: “Look up the contact for john@example.com”
- The AI should return contact details from HubSpot
Other test queries:
- “Create a contact for Jane at jane@company.com”
- “What's the status of the Enterprise Deal?”
- “Update the phone for contact john@example.com”
Troubleshooting
Invalid access token
Check that you copied the full access token. HubSpot tokens start withpat- followed by a region code.
Scope errors
If certain actions fail, verify your private app has the required scopes. You may need to add additional scopes and regenerate the token.
Contact not found
Contact lookups are by email. Ensure the email exists in HubSpot as a contact record.