Supabase no n8n: leia e grave dados nas tabelas
Crie a secret key, configure a credencial Supabase API, teste a leitura com Get Many, grave linhas, filtre Update e Delete com o Must Match certo e reaja a mudanças com Database Webhooks.
Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o tutorial: Supabase no n8n: leia e grave dados nas tabelas Arte: Eleven Host
Usar supabase no n8n é deixar o nó Supabase ler, criar, atualizar e apagar linhas de uma tabela do seu projeto, direto do fluxo.
A secret key do Supabase ignora as políticas de RLS (Row Level Security) e dá acesso amplo ao banco. Guarde essa chave só na credencial do n8n, fora de nós Code, notas, prints, repositórios Git e telas de front-end.
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 Supabase e o que o nó faz
O Supabase é uma plataforma que reúne banco de dados Postgres, autenticação de usuários, armazenamento de arquivos, tempo real e funções. O n8n tem um nó chamado Supabase para automatizar trabalho nessa plataforma, mas ele cobre uma parte pequena dela: linhas de tabela.
O nó tem um único recurso no editor, o Row, com cinco operações: Create, Delete, Get, Get Many e Update. A documentação do n8n usa outro nome para essa operação, mas no editor ela aparece como Get Many.
O que o nó Row não faz: cadastrar ou autenticar usuários do seu app, enviar arquivos para o armazenamento e rodar SQL livre. Para o que o nó não cobre, a documentação do n8n manda usar o nó HTTP Request com a credencial do Supabase; é o caminho para Auth e Storage. Para SQL, existe o nó Postgres, tratado mais abaixo.
Para quem serve
O nó serve a quem já roda o n8n na própria VPS e guarda dados numa tabela do Supabase: leads de um formulário, pedidos, cadastros, registros de um app. Se a VPS ainda não existe, veja o que é um servidor VPS. Outra opção de base de tabelas ligada ao n8n está em Airtable no n8n: automatize bases e tabelas.
A mensalidade de uma VPS na Eleven Host é cobrada em reais. 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: ter um projeto com a Data API ligada
O nó conversa com o Supabase pela Data API do projeto, e a documentação do n8n lista essa API habilitada como pré-requisito, além de uma conta no Supabase. Crie um projeto no Supabase (ou, em servidor próprio, suba o seu com chaves novas, nunca as de exemplo) e crie uma tabela simples para os testes, por exemplo leads, com as colunas nome e email.
Passo 2: criar a secret key e copiar o endereço do projeto
No painel do Supabase, abra Project Settings > API Keys e crie ou revele uma secret key; ela começa com sb_secret_. O endereço do projeto (Project URL) fica em Integrations > Data API.
As chaves antigas, chamadas anon e service_role, estão em descontinuação: o Supabase informa que elas saem até o fim de 2026, e a documentação do n8n pede para trocar a chave legada por uma secret key nova antes disso.
A chave publishable (sb_publishable_) e a anon não servem nesta credencial: o n8n pede a secret.
Onde cada dado fica
- Host: o Project URL, em Integrations > Data API, sem o sufixo
/rest/v1; - Secret Key: em Project Settings > API Keys;
- Tabela: escolhida no próprio nó, pela lista ou por ID.
Quem acessa o n8n com essa credencial alcança o banco, então controle quem entra no n8n.
Passo 3: criar a credencial Supabase API
No n8n, crie uma credencial do tipo Supabase API e preencha dois campos: Host, com o endereço do projeto sem /rest/v1 (o nó acrescenta o caminho sozinho), e Secret Key.
No nó, o campo Authentication oferece Secret Key (padrão) e OAuth2. Para Supabase em servidor próprio, use a Secret Key; o Host muda, e a seção sobre servidor próprio, mais abaixo, mostra como.
Passo 4: testar a leitura com Row > Get Many
Crie um workflow com gatilho manual e adicione o nó Supabase. Escolha o recurso Row e a operação Get Many. Em Table Name or ID, selecione a tabela de teste. Com Return All desligado (o padrão), o campo Limit vem em 50, e o campo Order By aceita algo como created_at.desc. Execute o nó.
Se a tabela existe e volta vazia, vale conferir se a chave colada é a secret e não a pública, e se o schema está certo. Para outro schema que não o public, ligue Use Custom Schema e informe o Schema; esse schema precisa estar exposto na API do Supabase.
Para filtrar, o Get Many oferece None, Build Manually (padrão) e String; no modo manual há condições como Equals, Not Equals, Greater Than e LIKE operator.
Passo 5: gravar com Row > Create
Troque a operação para Create. O campo Data to Send tem duas opções: Define Below for Each Column (padrão) e Auto-Map Input Data to Columns. Comece pelo Define Below: clique em Add Field to Send e, em cada campo, escolha o Field Name or ID (a coluna) e o Field Value.
Execute o passo e confira a linha nova no painel do Supabase.
Passo 6: Update e Delete com o Must Match certo
Em Update e Delete, o filtro usa Select Type (Build Manually, padrão, ou String), as Select Conditions e o campo Must Match. Aqui mora uma armadilha: o padrão do Must Match é Any Select Condition: a operação atinge as linhas que baterem em uma das condições. Para exigir todas as condições, troque para All Select Conditions antes de executar.
Recomendamos testar o filtro com Get Many usando as mesmas condições e o mesmo Must Match. Se a lista que volta é a que você quer alterar ou apagar, repita no Update ou no Delete.
Passo 7: reagir a mudanças no banco
O n8n não tem um Supabase Trigger oficial. O caminho é usar os Database Webhooks do Supabase, que enviam dados do banco a outro sistema quando ocorre um evento na tabela, junto com o nó Webhook do n8n.
Na ordem: no n8n, adicione o nó Webhook (método POST) e copie a Production URL. No painel do Supabase, em Integrations > Webhooks, crie um webhook com nome, tabela e eventos INSERT, UPDATE e DELETE, apontando para essa URL. Ative o fluxo (passo 8) antes de esperar eventos: a Production URL só recebe com o fluxo ativo. O Supabase envia JSON com type, table, schema, record e old_record; no INSERT o old_record vem nulo, e no DELETE o record vem nulo.
O Supabase na nuvem precisa alcançar a URL pela internet, então localhost e o IP interno da VPS não servem como endereço do webhook. Recomendamos um endereço HTTPS público; com o n8n atrás de proxy reverso, confira se a variável N8N_WEBHOOK_URL (ou WEBHOOK_URL) tem esse endereço.
Passo 8: ativar o workflow
Salve e ative o workflow. A Production URL do nó Webhook, a que vai para o Supabase, depende de o workflow estar ativo.
Combinações para começar
Um exemplo: um formulário grava um lead. Um nó Webhook recebe os dados do formulário e liga ao nó Supabase com Row > Create, mapeando nome e e-mail para as colunas da tabela.
Um exemplo: uma linha nova avisa a equipe. O Database Webhook com INSERT chama o nó Webhook do n8n, que liga a um nó de mensagem, como Telegram ou e-mail, com o conteúdo de record.
Um exemplo: relatório diário. Um Schedule Trigger chama o nó Supabase com Row > Get Many, filtrando por data e ordenando por created_at.desc, e um nó de e-mail monta o resumo.
São exemplos de montagem. Ajuste tabelas, colunas e destinos ao que o seu n8n mostra e confira o resultado no seu servidor.
Supabase em servidor próprio e o nó Postgres
Se o Supabase roda na mesma VPS, em Docker, o n8n precisa alcançar o gateway da API, que atende na porta 8000. Segundo a documentação do n8n, com Supabase e n8n em contêineres separados, ambos entram na mesma rede bridge definida pelo usuário, e o Host é o nome do contêiner do gateway, como http://supabase-kong:8000. A documentação do Supabase diz que o gateway padrão hoje é o Envoy, então o nome pode ser outro: confira com docker ps. O valor localhost só vale se o n8n não estiver em contêiner.
Para SQL livre, use o nó Postgres, que entra como usuário do banco e não pela Data API. A conexão direta do Supabase é IPv6, ou IPv4 com o add-on; para rede só IPv4 sem add-on, o Supabase indica o pooler em modo sessão, na porta 5432. O SSL em require cifra a conexão, mas não confere o servidor.
Mantenha o n8n atualizado
Em 2026, o n8n publicou avisos de segurança sobre o nó Supabase, ligados a filtros e ao nome da tabela. As correções saíram nas versões 1.123.80, 2.39.6 e 2.40.1, e a estável de 16/11/2026, a 2.47.7, é posterior a elas. Recomendamos manter o n8n atualizado.
Um cuidado de uso: em Filters (String) e em Table Name, evite expressões com dado vindo de fora, como o corpo de um webhook. O próprio editor orienta usar $1, $2 e os parâmetros abaixo do campo, em vez de montar a string por expressão. O modo Build Manually é uma alternativa ao filtro por String, mas a correção é atualizar.
Mais leituras sobre n8n e dados
Quem prefere um painel e uma API para os próprios dados no servidor pode ver Directus na VPS: painel e API para seus dados.
Bronze, Prata, Ouro, Platina, Diamante e Titanium são os planos de VPS à venda. 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 nó Supabase faz login e cadastro de usuários?
Não. O nó tem só o recurso Row, para linhas de tabela. Auth e Storage ficam com o HTTP Request e a credencial do Supabase.
Existe um Supabase Trigger no n8n?
Não há nó oficial. Use os Database Webhooks do Supabase com o nó Webhook do n8n, com URL pública em HTTPS.
Posso colar a chave anon ou publishable na credencial?
Não. A credencial pede a secret key. Com a chave pública, o RLS pode devolver resultado vazio.
O nó Supabase roda comandos SQL?
Não. Para SQL, use o nó Postgres com a conexão do banco.