Notion no n8n: como criar páginas e ler bancos
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

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:
- abra o painel de integrações do Notion;
- clique no botão + New integration;
- informe um nome, como n8n integration, e, se quiser, um logotipo;
- clique em Submit para criar a integração;
- abra a aba Capabilities e marque Read content, Update content, Insert content e User information without email addresses;
- salve as mudanças;
- 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:
- abra a página no seu espaço de trabalho do Notion;
- clique no menu de três pontos, no canto superior direito;
- em Connections, clique em Connect to;
- 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:
- um Notion Trigger com o evento Page added to database, apontando para o banco de pedidos;
- 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;
- 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_toggleableverdadeiro, 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.