Ressources · Intégration n8n

Intégration Notion n8nAutomatiser Notion avec n8n.

Notion sert de base de données à tes workflows n8n, dans les deux sens. L'intégration Notion n8n tient sur deux nœuds : le nœud Notion, avec 14 opérations sur 5 ressources (pages, pages de base, bases, blocs, membres), et le Notion Trigger, qui relève les pages ajoutées ou modifiées à l'intervalle que tu fixes.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

Que permet l'intégration Notion n8n ?

Elle relie ton espace Notion au reste de tes outils, dans les deux sens. n8n lit tes bases, crée des pages, ajoute des blocs de contenu, met à jour des lignes, et réagit quand une page apparaît ou change. Deux nœuds suffisent : le nœud Notion pour agir, le Notion Trigger pour écouter. Tout se câble dans l'éditeur visuel, un workflow étant simplement la suite d'étapes que n8n enchaîne pour toi.

Une base de suivi qui se remplit sans copier-coller. Une demande arrive dans Gmail, n8n crée la ligne correspondante avec databasePage.create et remplit les colonnes au passage : statut, date, personne assignée. La base Notion reste la référence, la saisie manuelle disparaît.

Une alerte sans surveiller la base à la main. Le Notion Trigger écoute pageAddedToDatabase sur la base des demandes entrantes, databasePage.get relit la fiche complète, et le titre part dans Slack avec son échéance. Sur pagedUpdatedInDatabase, le même principe signale un changement de statut à la personne concernée.

Un export propre pour le reporting. databasePage.getAll sort les lignes d'une base, filtre sur une colonne avec Filter puis Filters, et déverse le résultat dans Google Sheets. Return All coché, n8n descend la base entière au lieu de s'arrêter au nombre inscrit dans Limit.

Le nœud ne couvre pas tout, autant le savoir avant de câbler. Les relations entre deux bases ne s'affichent que si elles sont à double sens : côté ressource Database Page, une relation à sens unique reste invisible dans la sélection comme dans les filtres. Quand l'opération manque au nœud dédié, le nœud HTTP Request appelle n'importe quel endpoint de l'API de Notion, la porte d'entrée technique du service, en réutilisant le même credential par authentification prédéfinie. Un credential, ce sont les identifiants enregistrés une fois dans n8n. Même logique pour un titre dépliable : le nœud crée le titre, l'appel direct ajoute la propriété is_toggleable.

Deux autres points valent le détour. Un champ vide ou nul repris d'un nœud précédent déclenche une erreur de validation côté Notion : un nœud If en amont, ou une valeur par défaut, évite l'exécution qui casse au milieu. Et l'intégration ne voit que les pages qu'on lui a partagées, donc une base oubliée répond par une erreur, pas par une liste vide.

Si tu débutes sur l'outil, la formation n8n pose les bases avant que tu ouvres ton premier nœud Notion, et l'avis n8n dit ce que l'outil fait bien et ce qu'il fait moins bien.

Connexion

Comment connecter Notion à n8n ?

  1. 01

    Créer l'intégration côté Notion

    Ouvre le tableau de bord des intégrations Notion, clique sur + New integration, donne-lui un nom parlant du genre n8n integration, puis Submit. Dans l'onglet Capabilities, coche Read content, Update content, Insert content et User information without email addresses, puis Save changes. Il te faut un compte Notion avec un accès administrateur pour aller au bout de cette étape.

  2. 02

    Partager les pages avec l'intégration

    Une intégration fraîchement créée ne voit rien du tout. Ouvre la page ou la base concernée, clique sur le menu à trois points en haut à droite, puis sur Connections et Connect to : ton intégration apparaît dans la liste, sélectionne-la. Tant qu'aucune page n'est partagée, chaque appel répond par une erreur. Une seule page suffit pour commencer les essais.

  3. 03

    Enregistrer les identifiants dans n8n

    Dans n8n, ouvre Credentials et choisis Notion : le champ Internal Integration Secret attend le jeton de l'onglet Secrets. Pour une intégration publique, bascule sur OAuth2 : l'OAuth Redirect URL affichée par n8n se colle dans les Redirect URI de Notion, puis tu reportes Client ID et Client Secret. Ce credential se crée une fois et se réutilise partout.

Déclencheurs

Le Notion Trigger dans n8n : une base, deux événements

Notion Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Notion. Il écoute 2 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Notion appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

page.*1
    paged.*1

      Notes de configuration

      01Notion TriggerCe nœud attend qu'il se passe quelque chose dans une base Notion, puis démarre la suite tout seul. Il en est à sa version 1 et connaît deux événements, pageAddedToDatabase et pagedUpdatedInDatabase, à choisir dans le paramètre Event. Il fonctionne par polling, c'est-à-dire que n8n interroge l'API de Notion à l'intervalle que tu fixes et sort un item par nouvel élément trouvé. Rien à enregistrer côté Notion, mais compte un délai égal à cet intervalle.

      Ce nœud attend qu'il se passe quelque chose dans une base Notion, puis démarre la suite tout seul. Il en est à sa version 1 et connaît deux événements, pageAddedToDatabase et pagedUpdatedInDatabase, à choisir dans le paramètre Event. Il fonctionne par polling, c'est-à-dire que n8n interroge l'API de Notion à l'intervalle que tu fixes et sort un item par nouvel élément trouvé. Rien à enregistrer côté Notion, mais compte un délai égal à cet intervalle.

      Paramètres clés

      • Database : la base surveillée, prise dans la liste déroulante, collée sous forme d'URL ou d'identifiant. Un nœud écoute une base : pour en surveiller trois, il en faut trois.
      • Poll Times : l'intervalle entre deux relevés, au plus toutes les minutes. C'est ici que se règle la réactivité du workflow.
      • Simplify : activé, n8n renvoie une version allégée de la réponse au lieu des données brutes, ce qui rend le mappage des champs bien plus lisible dans les nœuds suivants.
      Quand l'utiliser
      chaque fois que la base Notion est le point de départ du process, et pas sa destination.
      Cas d'usage
      un nœud par base surveillée, posé devant la chaîne qui traite les nouvelles entrées.
      02Page Added to DatabaseUne ligne de plus dans la base, et l'automatisation part. L'événement pageAddedToDatabase couvre tout ce qui crée une page dans la base surveillée : une saisie faite à la main, un formulaire branché sur Notion, ou une autre branche de tes workflows qui vient d'écrire dedans.

      Une ligne de plus dans la base, et l'automatisation part. L'événement pageAddedToDatabase couvre tout ce qui crée une page dans la base surveillée : une saisie faite à la main, un formulaire branché sur Notion, ou une autre branche de tes workflows qui vient d'écrire dedans.

      Quand l'utiliser
      quand c'est l'arrivée de la donnée qui compte, pas son évolution. Si la même page doit ensuite déclencher d'autres actions à chaque changement de statut, c'est l'autre événement qu'il te faut.
      Cas d'usage
      une base « Demandes entrantes » alimentée par l'équipe. Chaque nouvelle ligne déclenche la relecture de la fiche, l'envoi d'un accusé de réception et la création de la tâche correspondante chez la personne qui traite. Autre grand classique : la base de contenus, où chaque idée ajoutée part en revue.
      03Page Updated in DatabaseIci, c'est la modification qui fait office de signal. pagedUpdatedInDatabase réveille le workflow quand une page déjà présente dans la base change, sans que tu aies à comparer deux états à la main dans un nœud de code.

      Ici, c'est la modification qui fait office de signal. pagedUpdatedInDatabase réveille le workflow quand une page déjà présente dans la base change, sans que tu aies à comparer deux états à la main dans un nœud de code.

      Quand l'utiliser
      pour les process où l'état d'une fiche avance par étapes. Prévois un filtre juste après le trigger, sinon la moindre correction de faute de frappe relance toute la chaîne.
      Cas d'usage
      le suivi de production. Une carte passe en relecture, l'équipe concernée reçoit le message ; elle passe en publié, la ligne part vers le tableau de bord. Sur une base commerciale, le même événement sert à prévenir quand une opportunité change de montant ou de date de clôture.
      Actions

      Les 14 opérations du nœud Notion

      Le nœud Notion expose 14 opérations sur 5 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

      Matrice ressources × opérations
      RessourceCreateGetGet Child BlocksUpdateAppend AfterArchiveSearch
      Block
      Database
      Database Page
      Page
      User

      Block

      2 opérations
      01

      Append a block

      block.append

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Ajoute du contenu à la fin d'un bloc ou d'une page existante, sans toucher à ce qui s'y trouve déjà.

      Paramètres clés

      • Block : la page ou le bloc qui reçoit le contenu, pris dans la liste ou collé en identifiant, souvent {{ $json.id }}, c'est-à-dire une valeur venue du nœud précédent.
      • Blocks : la pile de contenus à ajouter, bouton Add Block, avec le type à choisir (Heading 1 à Heading 3, texte enrichi, case à cocher).
      Cas d'usage
      coller le compte rendu d'un appel au bas de la page du client concerné. À savoir : le nœud crée des titres simples, jamais des titres dépliables.
      02

      Get many child blocks

      block.getAll

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Lit les blocs enfants d'une page ou d'un bloc et les renvoie un par un. C'est la porte d'entrée quand n8n doit lire ce qui est écrit dans une page, pas seulement les propriétés d'une ligne.

      Paramètres clés

      • Block : le parent dont on lit les enfants, désigné par la liste, l'URL ou l'identifiant.
      • Return All : coché, n8n remonte tous les blocs de la page ; décoché, il s'arrête au nombre fixé dans Limit.
      • Also Fetch Nested Blocks : descend aussi dans les blocs contenus dans d'autres blocs.
      Cas d'usage
      récupérer le texte d'une page de documentation pour en tirer un résumé avec un modèle de langage.

      Database

      3 opérations
      03

      Get a database

      database.get

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Récupère une base à partir de son identifiant et renvoie sa définition telle que Notion la décrit. Rien n'est modifié : c'est une lecture, souvent placée en début de workflow pour vérifier le terrain.

      Paramètres clés

      • Database : la base à lire, prise dans la liste déroulante, par URL ou par identifiant.
      • Simplify : coché, la réponse arrive aplatie ; décoché, tu reçois la structure brute, plus verbeuse mais complète quand tu cherches un détail précis.
      Cas d'usage
      contrôler qu'une base existe toujours, et sous quelle forme, avant qu'un workflow y écrive des dizaines de lignes d'affilée.
      04

      Get many databases

      database.getAll

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Liste les bases auxquelles l'intégration a accès. Rappel qui évite une perte de temps : cette liste ne contient que ce qui lui a été partagé, jamais l'espace de travail complet.

      Paramètres clés

      • Return All : coché, n8n parcourt toutes les bases accessibles ; sinon il rend la main au bout du nombre inscrit dans Limit.
      • Simplify : garde l'essentiel de chaque base au lieu de la réponse brute, suffisant quand tu ne veux que les noms et les identifiants.
      Cas d'usage
      faire l'inventaire des bases réellement connectées quand tu reprends un espace Notion monté par quelqu'un d'autre.

      Database Page

      4 opérations
      06

      Create a database page

      databasePage.create

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Crée une ligne dans une base, autrement dit une page dont les propriétés sont les colonnes de la base.

      Paramètres clés

      • Database : la base qui reçoit la nouvelle ligne.
      • Title : le texte du titre de la ligne, en général repris du nœud précédent.
      • Properties : une entrée par colonne (Add Property) : Key Name or ID désigne la colonne, puis vient le champ du type correspondant, de Status Name or ID à Relation IDs.
      • Ignore If Empty : à activer quand la valeur vient d'un nœud précédent, une propriété vide faisant échouer la validation Notion.
      Cas d'usage
      transformer chaque candidature reçue en ligne d'une base de recrutement, statut et date déjà posés.
      07

      Get a database page

      databasePage.get

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Renvoie une ligne précise avec ses propriétés, à partir de son identifiant. C'est le complément naturel du trigger, qui annonce l'événement là où la fiche complète, elle, mérite une relecture.

      Paramètres clés

      • Database Page : la page à lire, désignée dans la liste, par URL ou par identifiant, le plus souvent {{ $json.id }} repris du nœud d'avant.
      • Simplify : sort les propriétés à plat, pratique pour brancher un champ directement dans un message ; décoché, chaque type garde son détail d'origine.
      Cas d'usage
      relire une demande dans son intégralité avant qu'un nœud If décide si elle part en validation ou en refus.
      08

      Get many database pages

      databasePage.getAll

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Sort les lignes d'une base, avec ou sans filtre. C'est l'opération qui remplace l'export fait à la main le lundi matin.

      Paramètres clés

      • Database : la base à parcourir.
      • Filter : None, Build Manually pour composer des conditions dans Filters (Add Condition), ou JSON pour coller un filtre déjà écrit dans Filters (JSON).
      • Property Name or ID et Condition : la colonne testée et son opérateur, de equals à is_not_empty.
      • Return All : à cocher pour sortir la base entière ; sinon Limit plafonne le nombre de lignes.
      Cas d'usage
      lister chaque matin les tâches dont la date est dépassée et le statut toujours ouvert.
      09

      Update a database page

      databasePage.update

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Modifie les propriétés d'une ligne existante, repérée par son identifiant.

      Paramètres clés

      • Database Page : la ligne à mettre à jour, reprise du trigger ou d'une recherche précédente.
      • Properties : les colonnes à changer, une par entrée Add Property, avec la valeur qui va avec le type (Checked, Date End, Option Names or IDs).
      • Ignore If Empty : empêche d'écraser une colonne quand le nœud précédent n'a rien renvoyé pour elle.
      Cas d'usage
      basculer une ligne en terminé dès que la tâche se ferme ailleurs. Piège connu : une relation à sens unique ne se met pas à jour depuis le nœud, il faut un HTTP Request.

      Page

      3 opérations
      10

      Archive a page

      page.archive

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Archive une page Notion depuis un workflow, exactement comme tu le ferais à la main dans l'interface. Son identifiant suffit à la désigner.

      Paramètres clés

      • Page : la page à archiver, choisie dans la liste, par URL ou par identifiant.
      • Simplify : renvoie une réponse allégée après l'archivage, largement suffisante pour confirmer que l'opération a eu lieu.
      Cas d'usage
      désencombrer un espace de notes de réunion en archivant les pages dont la date est passée depuis plusieurs mois.
      11

      Create a page

      page.create

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Ouvre une nouvelle page sous une page existante. Le parent et le titre sont obligatoires, le contenu peut partir avec.

      Paramètres clés

      • Parent Page : la page qui accueille la nouvelle page, désignée dans la liste, par URL ou par identifiant.
      • Title : le titre affiché en haut de la page, celui que la recherche rapide de Notion retrouve. Marqué requis, il bloque l'exécution du nœud s'il arrive vide.
      • Blocks : le contenu posé dès la création (Add Block), avec Type Name or ID pour le type et Text pour le texte.
      Cas d'usage
      ouvrir une page de compte rendu sous la page « Réunions » dès qu'un rendez-vous se termine.

      User

      2 opérations
      13

      Get a user

      user.get

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Donne la fiche d'un membre de l'espace de travail à partir de son identifiant. Un détail qui compte : si la capacité cochée côté Notion est « User information without email addresses », l'adresse mail ne fait pas partie du lot.

      Paramètres clés

      • User ID : l'identifiant du membre, seul champ demandé par l'opération, en général récupéré depuis une colonne de type personne.
      Cas d'usage
      afficher le nom du responsable d'une tâche dans une notification, là où la base ne renvoie qu'un identifiant illisible.
      14

      Get many users

      user.getAll

      Ce que tu vois dans n8n

      Notes & cas d'usage

      Remonte les membres de l'espace de travail visibles par l'intégration. Aucun champ obligatoire, l'opération part telle quelle dès que le credential est en place.

      Paramètres clés

      • Return All : coché, la liste complète remonte ; décoché, Limit fixe le nombre de membres renvoyés.
      Cas d'usage
      construire une table de correspondance entre identifiants et noms, gardée de côté pour toutes les notifications que le workflow enverra ensuite.
      Besoin d'aide

      Besoin d'aide pour automatiser Notion avec n8n ?

      L'équipe te répond directement.

      Chaque message est lu par une personne.

      FAQ

      Questions fréquentes

      01L'intégration Notion n8n est-elle gratuite ?
      Oui. Le nœud Notion et le Notion Trigger sont livrés avec n8n : aucune installation, aucun coût supplémentaire côté n8n, sur n8n Cloud comme sur une instance auto-hébergée en Community Edition, sous licence Sustainable Use. L'auto-hébergement passe par Docker ou npm, et un workflow reste identique dans les deux cas. Côté Notion, il faut un compte avec un accès administrateur pour créer l'intégration qui délivre le jeton, puis partager avec elle les pages et les bases que tes automatisations vont toucher. Ce que coûte ton plan Notion dépend de ton abonnement et sort du périmètre de cette page.
      02Quels credentials faut-il pour connecter Notion à n8n ?
      Deux méthodes, au choix. L'API Key convient aux intégrations internes, réservées à un seul espace de travail : tu crées une intégration dans Notion, tu coches les capacités Read content, Update content, Insert content et User information without email addresses, puis tu copies l'Internal Integration Token dans le champ Internal Integration Secret de n8n. OAuth2 vise les intégrations publiques, utilisables dans plusieurs espaces : tu actives la distribution publique, tu ajoutes l'OAuth Redirect URL de n8n dans les Redirect URI de Notion, puis tu reportes le Client ID et le Client Secret. À savoir : une intégration publique passe par une revue de sécurité de Notion avant publication.
      03Quelles sont les limites du nœud Notion dans n8n ?
      Trois limites reviennent souvent. Les relations entre bases ne s'affichent que si elles vont dans les deux sens : sur la ressource Database Page, une relation à sens unique n'apparaît ni dans la sélection ni dans les filtres, et sa mise à jour demande un nœud HTTP Request en PATCH sur l'API des pages, avec le même credential. Les titres dépliables ne sont pas gérés non plus : le nœud crée un titre simple, la propriété is_toggleable s'ajoute ensuite par appel direct. Enfin, un champ vide ou nul venu d'un nœud précédent déclenche une erreur de validation, donc teste la donnée avec un nœud If ou pose une valeur par défaut. Sur les listes, Return All enchaîne les pages de l'API pour tout ramener, sinon Limit fixe le nombre maximal d'items.
      04Le Notion Trigger se déclenche-t-il immédiatement ?
      Non. Le Notion Trigger fonctionne par polling, autrement dit un relevé à intervalle régulier : n8n interroge l'API de Notion aussi souvent que tu le demandes dans Poll Times, au plus toutes les minutes, et émet un item par nouvel élément trouvé. Aucun webhook à configurer côté Notion, mais un délai égal à l'intervalle choisi, à garder en tête quand le process d'après est urgent. Deux événements sont disponibles sur la base choisie dans le paramètre Database, Page Added to Database et Page Updated in Database. Et si ton point de départ n'est pas une base de données, le trigger ne le couvre pas, c'est alors le nœud Notion qui prend le relais dans un workflow démarré autrement.
      05n8n ou Make pour automatiser Notion ?
      Ça dépend de trois critères. L'hébergement d'abord : n8n s'auto-héberge avec Docker ou npm, ou s'utilise sur n8n Cloud, là où Make est une plateforme hébergée, sans option d'auto-hébergement. Le modèle de coût ensuite : Make se facture à l'opération, ce qui se compare mal à une instance que tu fais tourner toi-même, donc chiffre ton volume mensuel avant de trancher. La maîtrise des données compte aussi si le contenu de tes pages Notion ne doit pas quitter ton infrastructure. Côté couverture, le nœud Notion propose 14 opérations sur 5 ressources et un trigger sur 2 événements, et quand une opération manque, le nœud HTTP Request appelle l'API Notion avec le même credential. Les deux outils se pilotent en visuel.
      Hack'celeration Lab

      Reçois nos tips intégration chaque semaine.

      Pas de spam. Désinscription à tout moment.