HubSpot CRM integration with n8n step by step

If you're using HubSpot CRM and want to automate your workflows, integrating it with n8n is one of the most efficient ways to gain more control without writing complex code. Whether you're trying to automate lead follow-ups, sync contacts to Google Sheets, or connect your CRM with a chatbot, the n8n HubSpot integration offers limitless flexibility. In this post, we'll walk you through a step-by-step guide to connect HubSpot with n8n, along with real examples that show you how powerful this combo can be.

Why Use n8n for HubSpot Automation?

HubSpot has powerful in-built automation, but it's not always flexible or affordable for growing teams. That’s where n8n steps in—a low-code, open-source automation tool that puts you in full control.

Here’s why the n8n HubSpot integration is a game-changer:

• Custom workflows without the limits of paid HubSpot automation features
• Trigger-based events such as “New Contact Created” or “Deal Updated”
• Multi-app connectivity to tools like Gmail, Slack, Google Sheets, Airtable, Notion, and more
• Self-hosted options for privacy and compliance

If you haven’t installed n8n yet, check out this free guide to run it locally or in the cloud.

Step-by-Step Setup for n8n HubSpot Integration

Let’s start with the standard integration of HubSpot using the built-in n8n node.

Step 1: Get Your HubSpot API Key or Private App Token

HubSpot has transitioned from legacy API keys to private apps for better security. Here’s how to get your token:

1. Log in to HubSpot and go to Settings > Integrations > Private Apps
2. Click Create private app
3. Give your app a name like "n8n Integration"
4. Under Scopes, select relevant scopes you need (e.g., CRM > contacts, deals, lists)
5. Click Create App
6. Copy the Access Token – you’ll need it in n8n

Tip: Always store your token securely using n8n's Credential system.

Step 2: Create HubSpot Credentials in n8n

1. Open n8n and go to Credentials from the sidebar
2. Click New Credentials > HubSpot
3. Fill in:
   • Authentication: Select “Access Token”
   • Access Token: Paste the token from Step 1
4. Save the credentials for later use in workflow

Step 3: Build Your First Workflow in n8n Using HubSpot Node

Now that credentials are set, let’s build a sample automation: Get all new HubSpot contacts and send them a Slack notification.

Example Workflow: Notify Slack on New HubSpot Contact

1. Start with a HubSpot Trigger

   • Resource: Contact
   • Event: Contact Created
   • Select your credentials

2. Add a Slack Node

   • Action: Send Message
   • Channel: Select your Slack channel
   • Message Text: “New contact alert! {{ $json.properties.firstname.value }} just signed up.”

3. Connect both nodes and activate the workflow

If you're new to triggers, check out this full guide to n8n triggers

This simple flow keeps your sales or support team instantly informed whenever a new lead signs up in HubSpot.

Advanced Use Cases for HubSpot and n8n

Once you’ve experienced how easy it is to get data in and out of HubSpot using n8n, you can scale it with more advanced use cases. Here are a few examples:

Auto-Enrich New Contacts with Clearbit or FullContact

• After a contact signs up, fetch additional company or social profile data and update the contact in HubSpot

Sync HubSpot Deals to Google Sheets

• Schedule a daily sync that exports all deal data into a Google Sheet for your finance team

Score Leads and Route to Sales

• Use an n8n IF node to assign a score based on HubSpot contact properties and auto-assign high-value leads to your CRM pipeline

Enrich Contacts via a Chatbot

• Combine with a chatbot built using n8n that feeds user interaction data into HubSpot as notes or custom properties

Mapping HubSpot Data in n8n

When working with HubSpot nodes in n8n, you'll often deal with data structures like this:

{
  "properties": {
    "firstname": {
      "value": "Jane"
    },
    "lastname": {
      "value": "Doe"
    },
    "email": {
      "value": "jane@example.com"
    }
  }
}

To access the first name in a Slack message, you would write:

{{ $json.properties.firstname.value }}

If you’re building outbound automation, like creating new HubSpot contacts from form data, your workflow would look like:

• Trigger from form submission (Webhook, Email, Typeform, etc.)
• HubSpot Node > Action: Create a contact
• Map data like First Name, Last Name, Email using expression fields

Pro Tips for Scaling n8n HubSpot Integration

• Use environment variables for tokens to avoid hardcoding credentials
• Error handling is vital for data syncs with third-party APIs. Learn how to create robust retry logic with our error handling guide
• Rate limits: HubSpot limits API calls (~100/sec/user). Always batch and throttle in large syncs

Here’s a quick comparison table for when to use common HubSpot operations in n8n:

Useful External Resources

• HubSpot Developer Docs
• n8n HubSpot Integration Guide
• OAuth2 Token Troubleshooting

FAQ

Can I use the HubSpot integration in the free version of n8n?

Yes, the HubSpot node is available in the free and self-hosted version of n8n. It's open source and doesn’t require a paid license to use.

What if my HubSpot token stops working?

This often happens if the private app token is rotated or permissions change. Revisit the private app in HubSpot, regenerate the token, and update the credential in n8n.

Does n8n support HubSpot OAuth2?

Yes, OAuth2 is supported for cloud-hosted apps. However, using a private app access token is simpler for most self-hosted workflows.

How often can I run workflows with HubSpot?

You can trigger workflows based on real-time events (like “new contact created”) or schedule them at set intervals using the Cron node. Be mindful of HubSpot API limits.

Can I sync both ways, from HubSpot to other apps and back?

Absolutely. With n8n, you can both read from and write to HubSpot, enabling full two-way sync with tools like Google Sheets, Notion, ClickUp, and more.

The n8n HubSpot integration unlocks enterprise-grade automation for marketers, sales teams, and startups alike. With modular building blocks and a powerful visual editor, it’s easy to experiment and scale without being locked into rigid platforms.