Base de Conhecimento

Notion no n8n: como criar páginas e ler bancos

  • notion, n8n, automação, integração, notion trigger, credencial
  • Usuários acharam útil: 0

Aprenda a usar o Notion no n8n: criar a integração, configurar a credencial, compartilhar a página com ela, usar as operações do nó, o Notion Trigger e resolver erros.

Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: Notion no n8n: como criar páginas e ler bancos

Capa da Redação Eleven Host para o guia: Notion no n8n: como criar páginas e ler bancos Arte: Eleven Host

Para usar o Notion no n8n, você cria uma integração no Notion, cola o token numa credencial do n8n e compartilha a página com essa integração. Com isso, o nó Notion cria páginas, lê bancos e atualiza registros dentro do fluxo.

Atualizado em 04/11/2026. A página de notas de versão do n8n lista como mais recente a 3.0, de 27/10/2026, que o n8n descreve como uma versão grande com mudanças que quebram compatibilidade. Confira o comportamento do nó na versão que você usa.

O que você precisa antes de começar

A documentação do n8n pede uma conta do Notion com acesso de administrador. Ela também descreve dois métodos de autenticação para a credencial:

  • API integration token: usado para integrações internas;
  • OAuth2: usado para integrações públicas, que exigem uma revisão de segurança do Notion antes de serem publicadas.

Este passo a passo segue a integração interna.

Passo 1: criar a integração no Notion

Os passos da documentação do n8n são estes:

  1. abra o painel de integrações do Notion;
  2. clique no botão + New integration;
  3. informe um nome, como n8n integration, e, se quiser, um logotipo;
  4. clique em Submit para criar a integração;
  5. abra a aba Capabilities e marque Read content, Update content, Insert content e User information without email addresses;
  6. salve as mudanças;
  7. abra a aba Secrets, copie o Internal Integration Token e guarde-o para a credencial do n8n.

As telas do Notion podem mudar. A documentação do próprio Notion chama a integração interna de conexão e fala em um token que fica na aba Configuration. Se os nomes das abas forem diferentes dos acima, procure o token de API da integração na tela de configuração dela.

Criar a integração não é suficiente: segundo a documentação, depois de compartilhar ao menos uma página com ela é que você pode fazer requisições à API. Se a página não foi compartilhada, a requisição responde com erro.

Passo 2: criar a credencial no n8n

No n8n, crie uma credencial do Notion e cole o token no campo do segredo da integração interna (Internal Integration Secret). Para uma integração pública, use o OAuth2: cole a OAuth Redirect URL que o n8n mostra no campo Redirect URI do Notion e copie o Client ID e o Client Secret da aba Secrets para o n8n.

Recomendamos tratar o token como uma senha: não o cole em mensagens, em capturas de tela nem em fluxos compartilhados.

Passo 3: compartilhar a página com a integração

Sem este passo, a requisição responde com erro. A documentação do n8n descreve assim:

  1. abra a página no seu espaço de trabalho do Notion;
  2. clique no menu de três pontos, no canto superior direito;
  3. em Connections, clique em Connect to;
  4. use a busca para achar a sua integração na lista e selecione-a.

A documentação do Notion descreve o mesmo caminho com o nome Add connections no menu. O nome pode variar conforme a versão da tela, então procure a opção de conexões no menu da página.

Compartilhe com a integração a página que o fluxo vai usar.

Quais ferramentas fazem parte da sua rotina de trabalho? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

O que o nó Notion faz: recursos e operações

Segundo a documentação do n8n, estas são as operações do nó, por recurso:

  • Block: Append After, Get Many e Get Markdown;
  • Data Source: Get e Search;
  • Database: Get;
  • Database Page: Create, Get, Get Many e Update;
  • Page: Archive, Create, Get Markdown, Search e Update Markdown;
  • User: Get e Get Many.

A página também marca o nó como utilizável como ferramenta de IA, e diz que muitos parâmetros podem ser preenchidos automaticamente ou pela IA.

Para criar uma página dentro de um banco, a operação é Create no recurso Database Page. Para ler os registros, use Get Many no mesmo recurso.

Database e Data Source: o que mudou na API do Notion

O Notion mudou o modelo na versão da API 2025-09-03: um banco pode conter várias fontes de dados (data sources) ligadas. A documentação do Notion diz que boa parte das operações que usavam o identificador do banco passou a pedir o identificador da fonte de dados, e que a mudança não é compatível com o modelo anterior.

Segundo o guia de atualização do Notion, conexões em versão antiga continuam funcionando até alguém acrescentar uma segunda fonte de dados ao banco. A partir daí, criar páginas nele, ler, gravar, consultar e usar relações para ele falham. O nó do n8n já tem o recurso Data Source separado do Database, com as operações Get e Search. Todas as requisições REST do Notion devem levar o cabeçalho Notion-Version.

Há uma mudança mais recente, de 2026-03-11, com três quebras de compatibilidade: o parâmetro after virou um objeto position, o campo archived virou in_trash e o bloco transcription virou meeting_notes.

Notion Trigger: começar o fluxo quando algo muda

O Notion Trigger tem dois eventos, segundo a documentação do n8n: página adicionada ao banco (Page added to database) e página atualizada no banco (Page updated in database). O gatilho funciona por consulta periódica (polling), isto é, o n8n verifica o Notion de tempos em tempos, e não recebe um aviso na hora.

Depois de ativar o fluxo, recomendamos criar ou editar uma página de teste e conferir na lista de execuções se o gatilho disparou.

Um exemplo de fluxo para adaptar

Um exemplo de fluxo para treinar, com os nomes das operações da documentação. A ideia é copiar para um segundo banco, o de arquivo, cada página nova do banco de pedidos:

  1. um Notion Trigger com o evento Page added to database, apontando para o banco de pedidos;
  2. um nó If que checa se o campo que você vai reaproveitar existe, porque a documentação orienta verificar a existência do dado antes de enviá-lo ao Notion;
  3. um nó Notion com o recurso Database Page e a operação Create, que grava o registro no banco de arquivo.

Se o seu fluxo grava datas, o guia do Date & Time no n8n mostra como formatá-las antes de enviar. Para contar ou somar os itens que o Get Many devolve, veja o guia do Summarize no n8n.

Erros comuns e como contornar

A página de problemas comuns do nó, no n8n, traz três casos:

  • Relation property not displaying: o nó só mostra relações de mão dupla, aquelas com a opção de relação reversa ativada no Notion. Para uma relação de mão única, a documentação sugere o nó HTTP Request com a mesma credencial e uma requisição PATCH;
  • Create toggle heading: o nó não cria um título recolhível direto. Crie um título normal e depois altere o bloco, com is_toggleable verdadeiro, usando GET e PATCH;
  • Handle null and empty values: mandar um campo vazio ou nulo causa erro de validação. A documentação orienta checar se o dado existe antes de enviar ou usar um valor padrão, com um nó If ou um nó Set.

Erros da API do Notion

  • 404, object_not_found: o recurso não existe para aquele token. O Notion diz que também pode indicar que o recurso não foi compartilhado com o dono do token. Recomendamos conferir o compartilhamento primeiro quando o nó não achar a página ou o banco;
  • 401, unauthorized: o token não é válido;
  • 403, restricted_resource: o token não tem permissão;
  • 429, rate_limited: há requisições demais. Reduza o ritmo e tente de novo.

Limites de requisições e de tamanho

Segundo o Notion, os planos Business e Enterprise permitem 600 requisições por minuto, em média 10 por segundo. Os demais planos permitem 180 por minuto, em média 3 por segundo. Para consultas a uma fonte de dados, o limite é de cerca de 3 requisições por segundo por conexão. Quando o limite é passado, a API responde com 429, e o cabeçalho Retry-After traz, em segundos inteiros, quanto esperar.

Há também limites de tamanho. O conteúdo de um texto formatado (text.content) aceita 2000 caracteres, uma lista de blocos aceita 100 elementos e uma URL aceita 2000 caracteres. Um multisselect aceita 100 opções, uma relação aceita 100 páginas relacionadas, e um envio completo aceita 1000 elementos de bloco e 500 KB no total.

Para usar com outros fluxos

Se a sua automação lê e-mails e anota os resultados no Notion, o guia do Ler e-mails no n8n mostra a parte de receber e organizar as mensagens.

O que você pretende colocar no ar nos próximos meses? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

Como conectar o Notion ao n8n?

Crie uma integração interna no Notion, copie o token, crie uma credencial do Notion no n8n com esse token e compartilhe a página com a integração.

Por que o n8n não encontra a minha página do Notion?

Confira se a página foi compartilhada com a integração. A documentação diz que, sem o compartilhamento, a requisição responde com erro. O Notion também descreve o erro 404 object_not_found como possível sinal de recurso não compartilhado.

O Notion Trigger avisa na hora quando há uma página nova?

Não. Ele funciona por consulta periódica, o polling. O n8n verifica o Notion de tempos em tempos.

O nó Notion consegue criar uma página num banco?

Consegue. No recurso Database Page, a operação Create cria o registro, e Get Many lê os registros do banco.

Esta resposta lhe foi útil?

Artigos Relacionados