How to Connect HubSpot CRM with n8n (2026)

How to Connect HubSpot CRM with n8n

HubSpot CRM and n8n create a powerful open-source automation combination. n8n is a self-hostable workflow automation platform that gives you full control over your data and infrastructure. For teams that need to automate HubSpot workflows but prefer to keep data on their own servers, n8n offers a compelling alternative to cloud-only tools like Zapier or Make.

The n8n HubSpot node supports contacts, companies, deals, tickets, and engagements with full create, read, update, and delete capabilities. Because n8n is open source, you can extend the HubSpot node with custom functionality or connect it to internal APIs that closed-source platforms cannot reach.

This integration is ideal for technically savvy teams, startups with data privacy requirements, and organizations that want automation without per-operation pricing.

Integration Methods

Native Integration Setup

Step 1: Set Up n8n

Install n8n via npm (npm install -g n8n), Docker, or use n8n Cloud. Launch the editor at http://localhost:5678 for self-hosted instances.

Step 2: Create a New Workflow

Click New Workflow in the n8n editor. Add a trigger node (Schedule, Webhook, or another app) to start your workflow.

Step 3: Add the HubSpot Node

Click + to add a new node and search for "HubSpot." Select the HubSpot node and choose between OAuth2 or API Key authentication.

Step 4: Configure Authentication

For OAuth2, create a HubSpot app in your developer portal to obtain the Client ID and Client Secret. For API Key, generate a private app token in HubSpot → Settings → Integrations → Private Apps. Enter the credentials in n8n.

Step 5: Configure Operations

Select the resource (Contact, Company, Deal, Ticket, or Engagement) and the operation (Create, Update, Get, Get All, Delete). Map input data to HubSpot properties using n8n's expression editor.

Step 6: Test and Activate

Click Execute Workflow to test with live data. Review the output of each node. Once satisfied, toggle the workflow to Active.

What Data Syncs

Use Cases

Self-Hosted Lead Processing Pipeline

Receive form submissions via an n8n webhook, validate and enrich the data using internal databases, create a HubSpot contact, score the lead based on custom criteria, and route to the correct sales rep. All data stays on your infrastructure.

CRM-to-Data-Warehouse Sync

Schedule an n8n workflow to pull all updated HubSpot contacts daily, transform the data, and insert it into your PostgreSQL or BigQuery data warehouse for business intelligence reporting.

Automation Recipes

• When: a webhook receives form data → Then: create a HubSpot contact and send a Slack notification to the sales team
• When: a HubSpot deal is updated (via polling) → Then: sync the deal data to an internal project management database
• When: a scheduled trigger fires daily → Then: export all new HubSpot contacts to a CSV and upload to an SFTP server
• When: a HubSpot workflow sends a webhook → Then: process the contact through an internal ML scoring model and update their HubSpot properties

Troubleshooting

Authentication errors with OAuth2

Ensure your HubSpot app's redirect URI matches the callback URL configured in n8n (typically http://localhost:5678/rest/oauth2-credential/callback for self-hosted). Check that the required scopes (crm.objects.contacts.read, crm.objects.contacts.write, etc.) are selected in your HubSpot app settings.

Workflow stops processing large datasets

n8n loads all data into memory. For large HubSpot exports, use pagination by configuring the "Get All" operation with a limit, or use the HTTP Request node with HubSpot's pagination cursor. Increase n8n's memory allocation if running via Docker.

Limitations

n8n's HubSpot node does not cover all HubSpot API endpoints; custom objects and some newer API features may require the HTTP Request node. Self-hosted n8n requires infrastructure management (uptime, backups, updates). The free self-hosted version has no guaranteed SLA. HubSpot API rate limits apply (100 requests per 10 seconds for private apps, 200 per 10 seconds for OAuth). n8n Cloud pricing is based on workflow executions, which can grow with complex scenarios.