Chatspark
⌘K
⌘K

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

ActionDescription
Get ContactLook up contact information by email
Get DealCheck the status of a deal in your pipeline
Create ContactCreate a new contact record from chat conversation
Update ContactUpdate existing contact properties
Lead Capture
Use Create Contact to automatically capture leads from chat conversations directly into your HubSpot CRM.

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

  1. Log in to your HubSpot account
  2. Go to Settings (gear icon)
  3. Navigate to Integrations → Private Apps
  4. Click Create a private app
  5. Name it “ChatSpark Integration”

Step 2: Configure Scopes

  1. Go to the Scopes tab
  2. Add the following scopes:
    • crm.objects.contacts.read
    • crm.objects.contacts.write
    • crm.objects.deals.read
  3. Click Create app

Step 3: Get Your Access Token

  1. After creating the app, copy the Access token
  2. Keep this token secure — it provides access to your HubSpot data
Token Security
Your HubSpot access token is sensitive. Never share it publicly or commit it to version control.

Step 4: Enable in ChatSpark

  1. In ChatSpark, go to AI Actions
  2. Find HubSpot in the Library and click Enable
  3. Select the chatbot(s) that should have access
  4. Enter your Access Token
  5. Click Save

Configuration Fields

FieldDescriptionExample
Access TokenYour HubSpot private app access tokenpat-na1-xxxxx...

Testing Your Integration

After setup, test the integration:

  1. Open your chatbot widget
  2. Try asking: “Look up the contact for john@example.com”
  3. 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.

Need Help?
If you're having trouble with the HubSpot integration, contact our support team and we'll help you troubleshoot.

Previous

HappyFox Chat

Next

Intercom