HubSpot no n8n: automatize contatos e negócios
Crie a Service Key, troque a autenticação padrão, teste uma leitura de contatos e grave dados no CRM. Veja o que mudou para o HubSpot Trigger e uma alternativa por consulta periódica.
Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: HubSpot no n8n: automatize contatos e negócios Arte: Eleven Host
Usar hubspot no n8n é ligar o CRM ao fluxo: o nó HubSpot cria, atualiza, busca e apaga contatos, empresas, negócios e tickets, e assim cadastros e etapas de venda podem deixar de ser digitados duas vezes.
Troque a autenticação padrão "API Key" (desligada pelo HubSpot em 30/11/2022) por Service Key ou OAuth2 antes de criar a credencial.
Atualizado em 16/11/2026. Em 16/11/2026, a versão estável do n8n na página de lançamentos do projeto é a 2.47.7, publicada em 13/11/2026.
O que é o nó HubSpot
O nó HubSpot serve para automatizar trabalho no HubSpot e integrá-lo a outros aplicativos. Um nó novo no canvas usa a versão 2.3. No editor, os recursos são Company, Contact (o padrão), Contact List, Deal, Engagement e Ticket.
O recurso Contact tem estas operações: Create or Update (cria o contato ou atualiza o atual, se já existir), Delete, Get, Get Many, Get Recently Created/Updated e Search. Company e Deal têm um conjunto parecido, com Create como padrão e Update no lugar do upsert. Ticket tem Create, Delete, Get, Get Many e Update.
A página do nó na documentação do n8n usa nomes antigos, como "Create/Update a contact" e "Get all contacts", e lista um recurso Form. No editor, os nomes são Create or Update e Get Many, e o recurso Form não aparece. Também não existe Get Recently Created e Get Recently Modified separados: é uma operação só, Get Recently Created/Updated.
Para quem serve
Serve a quem usa o CRM HubSpot e roda o n8n na própria VPS, para criar contatos e negócios sem digitar. Se a VPS ainda não existe, veja o que é um servidor VPS. O desenho de um fluxo com planilhas e bases aparece em Airtable no n8n: automatize bases e tabelas.
Mensalidade em reais, por plano de VPS, aparece na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS
Passo 1: escolher entre Service Key e OAuth2
O nó aceita duas formas de entrar: Service Key e OAuth2. A documentação do n8n indica a Service Key. Ela é uma opção de autenticação de conta para integrações de sistema para sistema, e o HubSpot a anunciou em 10/02/2026 em beta público. Confira no HubSpot o status atual antes de contar com ela em produção. Para criá-la, é preciso ter acesso a Developer Tools.
No n8n Cloud, o OAuth2 pode ser feito pelo botão "Connect my account". Em instalação própria, o OAuth2 exige criar um app público e colar a OAuth Redirect URL do n8n, e a criação de app público legado pela interface do HubSpot foi desligada (veja a seção do Trigger). Por isso, o restante segue pela Service Key.
O HubSpot também desligou a criação de app privado legado pela interface: em 28/09/2026 para contas criadas a partir dessa data e em 26/10/2026 para contas antigas. Os apps privados que já existem continuam funcionando.
Escopos que a documentação do n8n lista para o nó
crm.objects.contacts.readecrm.objects.contacts.write: ler e gravar contatos;crm.objects.companies.readecrm.objects.companies.write: empresas;crm.objects.deals.readecrm.objects.deals.write: negócios;tickets: tickets;crm.lists.write: listas de contatos.
A lista completa da documentação inclui também oauth, forms, crm.schemas.companies.read, crm.schemas.contacts.read, crm.schemas.deals.read e crm.objects.owners.read. Recomendamos marcar só os escopos do que o fluxo vai usar.
Passo 2: criar a Service Key
No HubSpot, abra Development > Keys > Service Keys (ou Settings > Account Management > Integrations > Service Keys), crie uma chave, dê um nome, marque os escopos e confirme em Update e Create. Depois abra a chave, revele o valor e copie.
Passo 3: criar a credencial no n8n
No n8n, crie a credencial HubSpot Service Key e cole a chave no campo Service Key. A documentação do n8n chama esse campo de "App Token", mas no editor o nome é Service Key. O teste da credencial consulta os dados da conta.
Um caminho possível: quem já tem o token de um app privado antigo pode tentar usá-lo nesse mesmo campo, porque ele também funciona como Bearer. Confira no seu n8n.
Passo 4: trocar o Authentication no nó
Crie um workflow e adicione o nó HubSpot. Ele abre com o campo Authentication em API Key, um método que o HubSpot removeu. Antes de escolher a credencial, troque para Service Key (ou OAuth2) e só depois selecione a credencial do passo 3.
Passo 5: testar com Contact > Get Many
Antes de gravar, teste a credencial com uma leitura. No nó HubSpot do passo 4, em Resource, deixe Contact; em Operation, escolha Get Many. O Limit vem em 100, e o máximo é 250. Recomendamos baixar o Limit para um número pequeno no teste. Execute o nó.
Só depois de a leitura funcionar vale montar as automações de gravação.
Passo 6: gravar contatos, empresas e negócios
Em Contact > Create or Update, o n8n cria o contato ou atualiza o que já existe, e recomendamos essa operação para não duplicar cadastros. Em Company > Search, a busca é só pelo domínio do site da empresa, e não uma busca livre. Em Deal, as operações são Create, Delete, Get, Get Many, Get Recently Created/Updated, Search e Update.
O recurso Engagement registra Call, Email, Meeting e Task. O recurso Contact List tem Add e Remove, e o contato pode ser identificado por Email ou por Contact ID.
Recomendamos testar a gravação com um contato de teste, porque Delete e Update mudam dados reais do CRM.
O HubSpot Trigger: o que mudou para quem começa agora
O HubSpot Trigger inicia o workflow por webhook, com eventos como Contact Created, Deal Created, Ticket Created e os de Property Changed, que pedem o nome da propriedade. Ele usa outra credencial, a HubSpot Developer API, que pede Client ID, Client Secret, Developer API Key e APP ID de um app de conta de desenvolvedor. A Service Key não serve para webhook.
A documentação do n8n manda criar esse app pela tela de Apps da conta de desenvolvedor. Só que o HubSpot desligou a criação de app público legado pela interface: em 26/05/2026 para contas novas e em 23/06/2026 para contas antigas. Os apps legados que já existem não foram afetados. Para app novo, o HubSpot indica a CLI com Projects, e é preciso conferir se um app assim funciona com o Trigger do n8n.
Há ainda regras de uso: cada app aceita um único Trigger ativo, então ativar um segundo derruba o primeiro. O HubSpot precisa alcançar um endereço público, e recomendamos HTTPS. Com o n8n atrás de um proxy reverso, configure N8N_WEBHOOK_URL, com um valor como https://n8n.example.com/ (exemplo da documentação do n8n). Se o Client Secret estiver errado, o n8n descarta o evento sem mostrar erro. O HubSpot reenvia o webhook se a resposta passar de 5 segundos ou vier com erro, com até 10 tentativas em 24 horas.
Alternativa ao Trigger: consulta periódica
Um caminho possível, sem webhook, é um Schedule Trigger (a cada 15 minutos, por exemplo) ligado ao nó HubSpot com Contact > Get Recently Created/Updated. Ele tem atraso e gasta chamadas da API, mas não depende de app de desenvolvedor.
Combinações para começar
Um exemplo: um formulário do site vira contato. Um nó Webhook liga ao nó HubSpot com Contact > Create or Update, e o e-mail evita duplicar quem já existe.
Um exemplo: contatos novos avisam a equipe. Um Schedule Trigger chama Contact > Get Recently Created/Updated e envia o resumo por Slack ou e-mail. Veja Slack no n8n: mensagens e alertas automáticos para o lado das mensagens.
Um exemplo: um e-mail vira ticket. Um Email Trigger (IMAP) liga ao nó HubSpot com Ticket > Create.
São exemplos de montagem, não fluxos testados. Ajuste campos e destinos ao que o seu n8n mostra, e confira o resultado no seu servidor.
Problemas comuns
Estes códigos de erro do HubSpot ajudam a achar a causa:
- 401: autenticação inválida. Confira o Authentication e a chave colada;
- 403: a credencial não tem permissão para aquela URL, por exemplo por escopo faltando. Volte à Service Key e confira os escopos;
- 423: volume alto de sincronização; espere pelo menos 2 segundos entre chamadas;
- 429: acima do limite. Todas as chamadas seguintes falham até o limite zerar;
- 502 e 504: limite de processamento; pause e tente de novo.
Para apps privados, o HubSpot informa 100 chamadas por 10 segundos nos planos Free e Starter e 190 por 10 segundos nos planos Professional e Enterprise, com limite diário dividido entre os apps da conta. Em apps públicos OAuth, são 110 por 10 segundos por conta que instalou. A busca tem limite próprio. Em lotes, o nó Wait ou a opção Retry on Fail ajudam a respeitar esses limites.
Se o HubSpot Trigger não dispara, confira o Client Secret, o endereço público e se há outro Trigger ativo no mesmo app.
Prazos e referências
Em 15/09/2026, o HubSpot anunciou o fim do suporte às APIs v1 a v3 e aos apps legados, com aplicação em setembro de 2027. O nó e o Trigger do n8n usam caminhos desses tipos, e o suporte a eles segue até lá; depois de setembro de 2027, o que vale depende de o n8n atualizar os nós. Confira o aviso no HubSpot e o andamento no n8n.
As páginas dos nós HubSpot e HubSpot Trigger ficam em docs.n8n.io, e a referência da API, com limites e erros, em developers.hubspot.com. Recomendamos também manter o n8n atualizado com as versões estáveis do projeto.
VPS na loja da Eleven Host
A loja da Eleven Host tem uma página própria para servidores virtuais.
Preços por faixa de VPS, em reais por mês, ficam na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Consultar as VPS
Perguntas frequentes
Posso usar a API key do HubSpot?
Não. O HubSpot desligou o suporte a API key em 30/11/2022. Use Service Key ou OAuth2.
O nó HubSpot envia ou lê formulários?
Não. A documentação lista o recurso Form, mas o editor atual não o mostra.
Dá para receber eventos com a Service Key?
Não. A Service Key não suporta webhooks. Para eventos, o HubSpot Trigger usa a credencial HubSpot Developer API.