GitHub no n8n: automatize issues e repositórios
Crie o token, teste com o nó GitHub, configure o GitHub Trigger com endereço público e N8N_WEBHOOK_URL, ative o fluxo e entenda os erros 401, 403, 404 e 422.
Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o tutorial: GitHub no n8n: automatize issues e repositórios Arte: Eleven Host
Usar o github no n8n é ligar um fluxo ao seu repositório: o nó GitHub cria e consulta issues, releases e arquivos, e o GitHub Trigger inicia o workflow quando algo acontece no repositório.
O GitHub Trigger só recebe eventos se o GitHub conseguir chegar ao seu n8n por um endereço público. Em localhost, ele recusa a ativação.
Atualizado em 15/11/2026. Em 15/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 são o nó GitHub e o GitHub Trigger
O n8n oferece dois nós para trabalhar com o GitHub. O GitHub serve, segundo a documentação do n8n, para automatizar trabalho no GitHub e integrá-lo a outros aplicativos: você o coloca no meio do fluxo para executar uma operação, como criar uma issue. O GitHub Trigger é o gatilho: ele inicia o workflow quando ocorrem eventos no GitHub. O Trigger fica esperando um aviso do GitHub e, por isso, depende de um caminho de rede que o GitHub consiga usar, assunto tratado mais adiante.
Para quem serve
Serve a quem já roda o n8n na própria VPS e quer automatizar issues, releases e avisos de um repositório. Se a VPS ainda não existe, veja o que é um servidor VPS e como escolher um plano.
Cada mensalidade aparece em reais na página de VPS da loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Passo 1: criar o token no GitHub
O n8n conversa com o GitHub por meio de um token, que você cria na conta do GitHub antes de qualquer coisa no n8n. O caminho descrito na documentação do n8n é: Settings, Developer settings, Personal access tokens e Tokens (classic), com o botão Generate new token (classic). No campo Note, dê um nome que lembre o uso, como n8n integration.
Existem duas posições sobre qual tipo de token usar, e vale conhecer as duas. O n8n recomenda o token pessoal clássico (classic), com o escopo repo marcado para a maioria dos nós GitHub. Já o GitHub recomenda, sempre que possível, tokens pessoais fine-grained em vez dos clássicos. Segundo a documentação do n8n, eles limitam o acesso a repositórios e permissões específicos, mas têm algumas limitações.
Copie o token ao criá-lo e guarde-o como senha: o próprio GitHub orienta tratar tokens de acesso como senhas.
Token fine-grained: o que mudar
Se você escolher o fine-grained, as permissões precisam acompanhar o que o fluxo faz. Pela tabela de permissões do GitHub:
- criar webhook no repositório, que o GitHub Trigger faz ao ser ativado: Webhooks: write;
- criar issue: Issues: write;
- criar release: Contents: write, com requisitos adicionais.
O fine-grained tem um único dono e, em organização que exige aprovação, fica como pending e só lê informação pública até ser aprovado.
Validade do token
Na criação, o GitHub pede a validade do token. A documentação do n8n menciona a opção de escolher uma data ou marcar No expiration. Recomendamos escolher uma data e anotá-la: o token com validade deixa de funcionar sozinho nesse dia. No fine-grained, a validade padrão é de 30 dias.
Passo 2: criar a credencial no n8n
Com o token em mãos, crie a credencial no n8n. A documentação lista dois métodos. O API access token vale para os nós do GitHub. O OAuth2 vale somente para o nó GitHub e para o GitHub Trigger.
No formulário da credencial, o campo GitHub server fica como está; ele só muda em GitHub Enterprise Server. Preencha User com o seu usuário do GitHub e Access Token com o token copiado.
Passo 3: testar com o nó GitHub
Crie um workflow com um gatilho manual e adicione o nó GitHub. Escolha a credencial criada, o recurso Repository e a operação Get, informe o dono e o nome do repositório e execute o nó. Se os dados do repositório aparecerem na saída, o GitHub aceitou o token e a credencial.
Recursos e operações do nó GitHub
Nomes da documentação do n8n e da versão 2.47.7:
- File: Create, Delete, Edit, Get, List;
- Issue: Create, Create Comment, Edit, Get, Lock;
- Organization: Get Repositories;
- Pull Request: Close, Create, Create Comment, Edit Comment, Get, Get Diff, Get Patch, Merge, Reopen, Update;
- Release: Create, Delete, Get, Get Many, Update;
- Repository: Get, Get Issues, Get License, Get Profile, Get Pull Requests, List Popular Paths, List Referrers;
- Review: Create, Get, Get Many, Update;
- User: Get Repositories, Invite;
- Workflow, de GitHub Actions: Disable, Dispatch, Enable, Get, Get Usage, List.
Se o nó não tiver a operação de que você precisa, use o nó HTTP Request para chamar a API do GitHub.
Passo 4: configurar o GitHub Trigger
Só depois do teste, crie o workflow do gatilho. Adicione o nó GitHub Trigger com a mesma credencial e preencha:
- Repository Owner e Repository Name, ambos obrigatórios, que podem ser escolhidos em lista, por link ou pelo nome;
- Events, uma seleção múltipla. Entre as opções estão Push, Pull request, Issue comment, Release, Star e Fork, além de uma opção para todos os eventos;
- Insecure SSL, desligada de início: com ela desligada, o GitHub verifica o certificado do seu n8n.
Atenção ao evento Issues. Para uma issue nova, é ele que serve, e não o Issue comment, que dispara em comentários.
Segundo o GitHub, para criar webhooks num repositório é preciso ser o dono ou ter acesso de administrador a ele. Como o Trigger cria um webhook ao ser ativado, em repositório de terceiros sem esse acesso ele não consegue ser ativado.
Endereço público e N8N_WEBHOOK_URL
Ao ativar o workflow, o n8n usa a API do GitHub para criar um webhook no repositório, com um segredo aleatório, e o GitHub passa a enviar os eventos para a URL de webhook do seu n8n. Ao desativar, o n8n apaga esse webhook.
O Trigger recusa localhost, com uma mensagem que pede um domínio próprio para o n8n. Um endereço interno, como o da porta 5678, também deixa o GitHub sem caminho.
O n8n monta a URL de webhook a partir de N8N_PROTOCOL, N8N_HOST e N8N_PORT. Atrás de um proxy reverso, isso não funciona, segundo a documentação do n8n. A solução é definir a variável N8N_WEBHOOK_URL com o endereço público, por exemplo https://n8n.exemplo.com/. Ela existe desde a versão 2.30.0 e substitui a WEBHOOK_URL, obsoleta desde a 2.35.0. Em versões anteriores à 2.30.0, use a WEBHOOK_URL. Com Insecure SSL desligada, um certificado inválido pode levar o GitHub a recusar a entrega.
Passo 5: ativar o workflow
Com o workflow ativado, o n8n cria o webhook no repositório. Salve, ative o workflow e provoque o evento escolhido, como abrir uma issue de teste.
Combinações para começar
Três ideias; confira no seu n8n os nomes dos campos.
Um exemplo: avisar a equipe de uma issue nova. O GitHub Trigger, com o evento Issues, alimenta um nó do Telegram, do Slack ou de e-mail, e a mensagem leva o título e o link da issue.
Um exemplo: criar issue a partir de um formulário. O Form Trigger ou o Webhook recebe os dados e o nó GitHub, com Issue > Create, abre a issue.
Um exemplo: resumo diário. Um Schedule Trigger chama o nó GitHub com Repository > Get Issues, um filtro separa o que interessa e o resumo segue para a equipe. Se você quer acompanhar também páginas fora do GitHub, veja o artigo RSS no n8n: acompanhe sites e blogs automaticamente. Para quem quer um repositório Git próprio, há o artigo Forgejo na VPS: repositórios Git da equipe.
Problemas comuns
Quando algo falha, o código de erro ajuda a localizar a causa:
- 401: token errado, vencido ou revogado. Crie outro e atualize a credencial;
- 403: permissão ou escopo insuficiente, token fine-grained em
pendingou limite de requisições estourado; - 404 ao ativar o Trigger: o n8n sugere conferir se o repositório existe e se você tem permissão para criar os webhooks que o nó precisa. Em repositório privado sem acesso, o GitHub pode devolver 404;
- 422: o GitHub recusou criar o webhook, em geral porque já existe um igual. O n8n orienta apagar o webhook antigo e reativar o workflow.
Se o webhook foi criado, mas nada chega, revise: n8n em localhost, URL interna em vez da pública, falta de N8N_WEBHOOK_URL atrás de proxy, certificado inválido e workflow não ativado.
Há também o limite da API. Sem autenticação, o GitHub permite 60 requisições por hora; com token, o limite pessoal é de 5.000 requisições por hora. Ao estourá-lo, a resposta é 403 ou 429.
Mantenha o n8n atualizado
Recomendamos manter o n8n atualizado. O GitHub Trigger teve, em 2026, duas falhas de segurança que já foram corrigidas. A primeira permitia que quem soubesse a URL do webhook disparasse o workflow sem assinatura; a correção está na 2.5.0 e na 1.123.15. A segunda ocorria no caminho do erro 422, quando o segredo não era guardado; a correção está na 2.37.7, na 2.38.2 e na 1.123.76.
Esse retrato vale para 15/11/2026.
Onde ver as páginas de referência
As páginas dos nós, das credenciais e da URL de webhook ficam em docs.n8n.io; as regras de tokens, webhooks e limites estão em docs.github.com.
A loja mostra o valor mensal das VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
O GitHub Trigger funciona com n8n em localhost?
Não. O nó recusa localhost e pede um domínio próprio, porque o GitHub precisa alcançar a URL de webhook do n8n.
Qual token devo usar, classic ou fine-grained?
As duas recomendações divergem: o n8n recomenda o classic, com o escopo repo, e o GitHub recomenda o fine-grained. Com o fine-grained, lembre de Webhooks: write para o Trigger e Issues: write para criar issue.
Posso usar o Trigger em repositório de outra pessoa?
Em repositório de terceiros, não, a menos que você tenha acesso de administrador a ele, porque criar o webhook exige ser o dono ou ter esse acesso.