- O nó HubSpot usa OAuth 2.0 ou App Token; o nó HubSpot Trigger exige uma Developer API key.
- A integração cobre 18 gatilhos e 31 ações — contatos, deals, empresas, engajamentos e listas.
- No plano Free/Starter o limite de rajada é 100 requisições a cada 10 segundos.
- Fluxo clássico: formulário entra, cria contato, abre deal e avisa o time comercial.
Escolha o método de autenticação certo
Antes de sair clicando, decida como vai autenticar. O nó HubSpot (o que executa ações) aceita OAuth 2.0, App Token ou API Key legada. Já o nó HubSpot Trigger (que escuta eventos via webhook) só funciona com uma Developer API key, obtida numa conta de desenvolvedor do HubSpot. Confundir os dois é o motivo nº 1 de gente travar logo no começo — a doc oficial do n8n é explícita quanto a isso.
Crie um private app no HubSpot
Para ações simples, o caminho mais rápido é um private app. No HubSpot vá em Configurações → Integrações → Aplicativos privados → Criar aplicativo. Dê um nome, selecione os escopos (scopes) que você vai usar — como crm.objects.contacts.write e crm.objects.deals.write — e copie o token gerado. Só peça os escopos que o fluxo realmente precisa; sobra-escopo é risco à toa.
Adicione a credencial no n8n
No n8n, abra um workflow novo, clique no '+', busque 'HubSpot' e escolha o nó oficial. No campo de credencial, clique em 'Create new credential'. Para OAuth 2.0, use 'Connect my account' e aprove o portal na janela do HubSpot. Para private app, cole o App Token. O OAuth leva mesmo uns 5 minutos e é o recomendado para produção.
Configure a operação (criar contato, deal etc.)
Com a credencial ativa, escolha o Resource (Contact, Deal, Company...) e a Operation (Create, Update, Search, Delete). Ao criar um contato, mapeie e-mail, nome e telefone puxando os dados do nó anterior com expressões do tipo {{ $json.email }}. Para deal, defina o pipeline e o dealstage — é aqui que você move o lead de 'novo' para 'qualificado' de forma programática.
Ligue o gatilho e teste ponta a ponta
Coloque um gatilho na frente: um Webhook do n8n (para receber um formulário), um Schedule (para varrer registros modificados) ou o HubSpot Trigger (para reagir a mudança de propriedade de deal). Rode com 'Execute workflow', confira se o contato apareceu no HubSpot e só então ative. Comece com dados de teste antes de apontar para a base real.
O que dá para automatizar entre n8n e HubSpot
A conexão nativa expõe 18 gatilhos e 31 ações, segundo a página de integrações do próprio n8n. Na prática, isso cobre quase todo o ciclo comercial: criar, atualizar, buscar, mesclar e apagar contatos; abrir deals e mudar o estágio no funil; associar deals a contatos e empresas; e registrar engajamentos como ligações, e-mails, reuniões e notas.
A grande vantagem é usar o HubSpot como banco de dados de relacionamento e deixar o n8n orquestrar o resto — WhatsApp, planilha, IA, e-mail — sem depender dos limites de automação do plano do CRM.
Exemplo real: do formulário ao deal no funil
O fluxo mais pedido é simples de montar. O formulário do site dispara um Webhook no n8n. O primeiro nó HubSpot cria (ou atualiza, se já existir o e-mail) o contato. O segundo nó abre um deal no pipeline de vendas, no estágio inicial. Um terceiro nó avisa o vendedor — mensagem no WhatsApp ou canal do time.
É o mesmo raciocínio de quem já monta a ponte entre formulário e CRM: capturar o lead uma vez e propagar para todos os sistemas sem digitação manual. A diferença aqui é que o HubSpot carrega o histórico e o score, enquanto o n8n faz a costura.
Limites de API que você precisa conhecer
O HubSpot não libera chamadas infinitas. Para private apps nos planos Free e Starter, o limite de rajada é de 100 requisições a cada 10 segundos — o suficiente para a maioria dos fluxos de PME, mas fácil de estourar se você fizer um loop grande sem pausa.
Se o volume diário crescer muito (a casa das centenas de milhares de chamadas), a recomendação da comunidade é migrar para um app de desenvolvedor com limites maiores. Para fluxos que processam muitos registros de uma vez, use o nó de espera ou processe em lotes para não bater no teto e tomar erro 429.
Perguntas frequentes
Preciso saber programar para integrar n8n com HubSpot?
Qual a diferença entre o nó HubSpot e o HubSpot Trigger?
Dá para usar a integração no plano gratuito do HubSpot?
OAuth ou private app: qual escolher?
Leia também
Como conectar formulário ao CRM automaticamente com n8n
Passo a passo para conectar qualquer formulário — Google Forms, Typeform, Elementor, site próprio — ao seu CRM com n8n: webhook, deduplicação por e-mail e alerta pro time de vendas.
Ler →
Como qualificar leads automaticamente com IA usando n8n
Crie um fluxo no n8n que qualifica leads com IA automaticamente: coleta os dados, pontua o perfil, filtra os qualificados e avisa o time de vendas antes do vendedor abrir o CRM. Passo a passo.
Ler →
Como criar um agente SDR de IA com n8n para qualificar leads 24h
Passo a passo para montar um agente SDR de IA no n8n que recebe, responde e qualifica leads pelo framework BANT o dia inteiro — sem escrever código.
Ler →
Como automatizar follow-up de leads no WhatsApp com n8n
Crie uma régua de follow-up automática no WhatsApp com n8n: mensagens personalizadas por etapa do funil, intervalos configuráveis, integração com o CRM e parada quando o lead responde.
Ler →
O que é n8n? Guia completo para iniciantes em 2026
Entenda o que é n8n, como a ferramenta de automação funciona, quanto custa, se é difícil de aprender e como criar seu primeiro workflow sem saber programar.
Ler →