Mankomail

Notion ​

Lit et alimente vos pages et vos bases Notion : entrées, propriétés, contenu en Markdown, commentaires et pièces jointes.

Le nœud Notion lit et alimente vos pages et vos bases Notion : il interroge et crée des entrées de base, met à jour leurs propriétés, lit ou écrit le contenu d’une page en Markdown, ajoute des blocs, commente, et fait passer des fichiers dans les deux sens entre une page et les pièces jointes de l’exécution.

Il travaille avec un jeton d’intégration Notion enregistré une fois dans Connexions. Voir Notion pour créer la connexion. Un jeton Notion ne voit rien tant qu’aucune page ni aucune base ne lui a été partagée : dans Notion, ouvrez la page ou la base, puis le menu ···, Connexions, et ajoutez votre intégration.

Pour réagir à Notion sans sonder vous-même, utilisez le déclencheur Entrée Notion modifiée ou le déclencheur Notion — événement.

Dans Notion, une base de données est un conteneur qui héberge une ou plusieurs sources de données, et c’est la source qui porte les colonnes. L’éditeur demande donc la Base de données (celle que vous voyez dans Notion, ou son URL), puis la Source de données ; la plupart des bases n’en ont qu’une. Les pages se désignent par leur identifiant ou par leur URL Notion.

En bref ​

  • Type : notion.api · version 1
  • Catégorie : Données
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Écrit à l’extérieur (external_write) — écrit hors de Mankomail ; décrit au lieu d’être fait pendant un essai
  • Exige un mail porteur : Non
  • Connexion : Notion
  • Entrées : main
  • Sorties : main

Connexion ​

Ce nœud exige une connexion Notion.

Paramètres ​

connection ​

Connexion Notion — La connexion Notion à employer. Elle se crée une fois dans Connexions ; sa clé n’apparaît jamais dans le workflow.

  • Type : Connexion (credential)
  • Requis : Oui
  • Défaut : "" (vide)

resource ​

Ressource

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : dataSource
  • Options :
    • dataSource — Base de données : Lire, filtrer et alimenter les entrées d’une base.
    • page — Page : Créer, lire, modifier une page — et son contenu en Markdown.
    • block — Bloc : Ajouter du contenu au bas d’une page, ou lire ce qu’elle contient.
    • comment — Commentaire : Commenter une page pour prévenir quelqu’un, ou relire le fil.
    • file — Fichier : Téléverser une pièce jointe (du mail ou ajoutée par une étape) et l’attacher à une page, ou récupérer les fichiers d’une page en pièces jointes.
    • user — Utilisateur : Les personnes de l’espace de travail, et le compte de la connexion.
    • search — Recherche : Chercher par titre dans tout ce qui est partagé.

dataSourceOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : query
  • Options :
    • query — Rechercher des entrées : Avec un filtre et un tri — l’opération la plus utilisée.
    • changes — Entrées créées ou modifiées depuis… : Le sondage : posez un « Planification » en amont et passez-lui l’heure du passage précédent.
    • createEntry — Créer une entrée : Une ligne de la base, avec ses propriétés typées.
    • getSchema — Lire le schéma : Les propriétés de la source, leur type et leurs options.
    • list — Lister les bases : Tout ce qui est partagé avec la connexion.
  • Affiché quand : resource vaut dataSource

pageOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : create
  • Options :
    • create — Créer une page
    • get — Lire une page : Ses propriétés — pas son contenu, qui se lit en Markdown.
    • update — Mettre à jour les propriétés : Seules les propriétés fournies changent.
    • archive — Mettre à la corbeille / restaurer
    • getMarkdown — Lire le contenu en Markdown : Toute la page en un appel, prête pour un nœud IA.
    • updateMarkdown — Écrire du contenu en Markdown
  • Affiché quand : resource vaut page

blockOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : append
  • Options :
    • append — Ajouter des blocs
    • children — Lister les blocs
  • Affiché quand : resource vaut block

commentOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : create
  • Options :
    • create — Commenter
    • list — Lister les commentaires
  • Affiché quand : resource vaut comment

fileOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : upload
  • Options :
    • upload — Téléverser les pièces jointes : Celles du mail et les fichiers ajoutés par une étape précédente, filtrés comme partout ailleurs.
    • download — Récupérer les fichiers d’une page en pièces jointes : Rapatrie les fichiers dans les pièces jointes de l’exécution : un « Composer un mail » peut ensuite les joindre par leur position.
  • Affiché quand : resource vaut file

userOperation ​

Opération

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : list
  • Options :
    • list — Lister les personnes
    • me — Lire le compte de la connexion
  • Affiché quand : resource vaut user

parentType ​

Créer la page…

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : dataSource
  • Options :
    • dataSource — Dans une base de données
    • page — Sous une page
  • Affiché quand : resource vaut page et pageOperation vaut l’une de create

database ​

Base de données — Celle que vous voyez dans Notion. Vous pouvez aussi coller son URL.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (notion.database)
  • Listé avec la connexion de : connection
  • Affiché quand : (resource vaut dataSource et dataSourceOperation vaut l’une de query, changes, createEntry, getSchema) ou (resource vaut page et pageOperation vaut create et parentType vaut dataSource)

dataSource ​

Source de données — Le schéma appartient à la source, pas à la base. La plupart des bases n’en ont qu’une.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (notion.dataSource)
  • Listé à l’intérieur de : database
  • Listé avec la connexion de : connection
  • Affiché quand : (resource vaut dataSource et dataSourceOperation vaut l’une de query, changes, createEntry, getSchema) ou (resource vaut page et pageOperation vaut create et parentType vaut dataSource)

page ​

Page — L’identifiant ou l’URL de la page. Une entrée de base est une page : {{ data.notion.pageId }} convient.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (notion.page)
  • Listé avec la connexion de : connection
  • Affiché quand : (resource vaut page et pageOperation vaut l’une de get, update, archive, getMarkdown, updateMarkdown) ou (resource vaut page et pageOperation vaut create et parentType vaut page) ou resource vaut block ou resource vaut comment ou resource vaut file

title ​

Titre — Le titre de la page. Dans une base, il remplit la colonne de type « titre », quel que soit son nom.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 2000 caractères au plus
  • Affiché quand : (resource vaut page et pageOperation vaut l’une de create) ou (resource vaut dataSource et dataSourceOperation vaut l’une de createEntry)
  • Expressions : {{ }} accepté

properties ​

Propriétés — Le nom de la propriété, et sa valeur. La conversion suit le type déclaré dans Notion : une date en ISO, une liste séparée par des virgules, « oui » pour une case à cocher. Une valeur vide efface la propriété ; les colonnes calculées sont ignorées.

  • Type : Paires clé / valeur (keyValue)
  • Requis : Non
  • Affiché quand : (resource vaut page et pageOperation vaut l’une de create, update) ou (resource vaut dataSource et dataSourceOperation vaut l’une de createEntry)
  • Expressions : {{ }} accepté

markdown ​

Contenu (Markdown) — Notion convertit le Markdown en blocs lui-même : c’est la façon la plus sûre d’écrire un corps de mail, qui dépasse presque toujours les 2 000 caractères d’un fragment de texte.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 100000 caractères au plus
  • Affiché quand : (resource vaut page et pageOperation vaut l’une de create, updateMarkdown) ou (resource vaut dataSource et dataSourceOperation vaut l’une de createEntry)
  • Expressions : {{ }} accepté

markdownMode ​

Façon d’écrire

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : append
  • Options :
    • append — Ajouter à la fin : Rien n’est effacé — le choix par défaut, et celui d’un journal.
    • replace — Remplacer tout le contenu : Destructif : le contenu précédent disparaît.
  • Affiché quand : resource vaut page et pageOperation vaut l’une de updateMarkdown

inTrash ​

Mettre à la corbeille — Décoché, la page est restaurée depuis la corbeille.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : true
  • Affiché quand : resource vaut page et pageOperation vaut l’une de archive

filterProperty ​

Filtrer sur la propriété — Laissée vide, toutes les entrées sont rendues.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (notion.property)
  • Listé à l’intérieur de : dataSource
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de query

filterCondition ​

Condition

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : equals
  • Options :
    • equals — est égal à
    • does_not_equal — est différent de
    • contains — contient
    • does_not_contain — ne contient pas
    • starts_with — commence par
    • is_empty — est vide
    • is_not_empty — n’est pas vide
    • on_or_after — à partir du (date)
    • on_or_before — jusqu’au (date)
    • greater_than — est supérieur à (nombre)
    • less_than — est inférieur à (nombre)
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de query

filterValue ​

Valeur

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 2000 caractères au plus
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de query
  • Expressions : {{ }} accepté

filterJson ​

Filtre avancé (JSON) — Un filtre Notion complet (and / or, deux niveaux d’imbrication au plus). Rempli, il remplace le filtre simple ci-dessus.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 8000 caractères au plus
  • Exemple : {"property":"Statut","status":{"does_not_equal":"Clôturé"}}
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de query
  • Expressions : {{ }} accepté

sortProperty ​

Trier sur la propriété — Vide : Notion trie par date de dernière modification, de la plus récente à la plus ancienne.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant (notion.property)
  • Listé à l’intérieur de : dataSource
  • Listé avec la connexion de : connection
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de query

sortDirection ​

Sens du tri

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : ascending
  • Options :
    • ascending — Croissant
    • descending — Décroissant
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de query

since ​

Depuis — Un instant ISO 8601 (2026-09-22T07:00:00Z). Placez un déclencheur « Planification » en amont et passez {{ data.schedule.plannedFor }} : chaque passage ne rapporte que ce qui a bougé depuis le précédent.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 40 caractères au plus
  • Exemple : {{ data.schedule.plannedFor }}
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de changes
  • Expressions : {{ }} accepté

changeType ​

Ce qui déclenche

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : any
  • Options :
    • any — Créée ou modifiée
    • created — Nouvelle entrée seulement
    • edited — Entrée modifiée seulement
  • Affiché quand : resource vaut dataSource et dataSourceOperation vaut l’une de changes

blockText ​

Texte — Une ligne vide sépare deux blocs. Chaque bloc est découpé à 2 000 caractères, la limite de Notion.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 100000 caractères au plus
  • Affiché quand : resource vaut block et blockOperation vaut l’une de append
  • Expressions : {{ }} accepté

blockType ​

Type de bloc

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : paragraph
  • Options :
    • paragraph — Paragraphe
    • heading_1 — Titre 1
    • heading_2 — Titre 2
    • heading_3 — Titre 3
    • bulleted_list_item — Puce
    • numbered_list_item — Élément numéroté
    • to_do — Case à cocher
    • quote — Citation
    • callout — Encadré
    • code — Code
  • Affiché quand : resource vaut block et blockOperation vaut l’une de append

blockPosition ​

Où les poser

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : end
  • Options :
    • end — À la fin de la page
    • start — Au début de la page
  • Affiché quand : resource vaut block et blockOperation vaut l’une de append

commentText ​

Commentaire — Markdown en ligne : gras, italique, liens. Pas de blocs — un commentaire n’est pas une page.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 10000 caractères au plus
  • Affiché quand : resource vaut comment et commentOperation vaut l’une de create
  • Expressions : {{ }} accepté

discussionId ​

Répondre au fil — L’identifiant d’une discussion existante. Vide : le commentaire ouvre un nouveau fil sur la page.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Affiché quand : resource vaut comment et commentOperation vaut l’une de create
  • Expressions : {{ }} accepté

displayName ​

Signer le commentaire — Le nom affiché à côté du commentaire. Vide : le nom de l’intégration.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 100 caractères au plus
  • Affiché quand : resource vaut comment et commentOperation vaut l’une de create
  • Expressions : {{ }} accepté

selection ​

Pièces jointes retenues

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : all
  • Options :
    • all — Toutes les pièces jointes : Celles du mail déclencheur, puis les fichiers ajoutés par les étapes précédentes (un acte rapatrié, un PDF signé), dans cet ordre.
    • first — La première seulement : La première PJ, quand on sait qu’il n’y en a qu’une qui compte.
    • byMime — Par type de fichier : Par type MIME : application/pdf, ou toute une famille avec image/*.
    • byName — Par nom de fichier : Par motif sur le nom : *.pdf, facture-*.
  • Affiché quand : resource vaut file et fileOperation vaut l’une de upload

mime ​

Type de fichier — Type MIME exact (application/pdf) ou famille entière (image/*). Laissé vide, aucune PJ n’est retenue.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : application/pdf
  • Affiché quand : resource vaut file et fileOperation vaut l’une de upload
  • Expressions : {{ }} accepté

namePattern ​

Nom du fichier — Motif simple : * remplace n’importe quoi, ? un caractère (*.pdf, facture-*). La casse est ignorée.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : *.pdf
  • Affiché quand : resource vaut file et fileOperation vaut l’une de upload
  • Expressions : {{ }} accepté

fileTarget ​

Emplacement

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : block
  • Options :
    • block — Le contenu de la page : Téléverser : un bloc fichier par pièce jointe, au bas de la page. Récupérer : les blocs fichier, PDF et image de la page.
    • property — Une propriété « Fichiers » : Pour une entrée de base qui a une colonne de type fichier.
  • Affiché quand : resource vaut file

filesProperty ​

Nom de la propriété — La colonne de type « Fichiers et médias » de la base. Au téléversement, les fichiers déjà présents sont remplacés.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : Pièces jointes
  • Affiché quand : resource vaut file et fileTarget vaut property
  • Expressions : {{ }} accepté

maxDownloadMb ​

Taille maximale par fichier (Mo)

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 10
  • Nombre entier, de 1 à 10
  • Affiché quand : resource vaut file et fileOperation vaut l’une de download

searchQuery ​

Rechercher — La recherche porte sur les titres. Pour chercher dans une base, préférez « Rechercher des entrées » : la recherche globale est indexée, donc en léger retard.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 500 caractères au plus
  • Affiché quand : resource vaut search
  • Expressions : {{ }} accepté

searchObject ​

Chercher parmi

  • Type : Un choix (options)
  • Requis : Non
  • Défaut : page
  • Options :
    • page — Les pages
    • data_source — Les bases de données
    • any — Les deux
  • Affiché quand : resource vaut search

limit ​

Nombre maximum — Une requête de base ne peut de toute façon pas dépasser 10000 résultats : au-delà, découpez par plage de dates.

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 50
  • Nombre entier, de 1 à 500
  • Affiché quand : (resource vaut dataSource et dataSourceOperation vaut l’une de query, changes, list) ou (resource vaut block et blockOperation vaut l’une de children) ou (resource vaut comment et commentOperation vaut l’une de list) ou (resource vaut user et userOperation vaut list) ou resource vaut search

Sorties ​

  • main — Empruntée une fois l’opération Notion réussie. Une réponse d’erreur de Notion fait échouer l’étape à la place.

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ data.<step>.pageId }} — string. L’identifiant de la page concernée : la première entrée ou le premier résultat trouvé (Rechercher des entrées, Entrées créées ou modifiées depuis, Recherche), la page créée, lue ou écrite. Une entrée de base EST une page : cet identifiant convient à tout paramètre Page. Vide en essai pour une création.
  • {{ data.<step>.url }} — string. Créer une entrée, Créer une page, Lire une page, Mettre à jour les propriétés : le lien Notion de la page.
  • {{ data.<step>.page }} — { id, url, title, properties, createdTime, lastEditedTime, inTrash, dataSourceId }. Créer une entrée, Créer une page, Lire une page, Mettre à jour les propriétés : la page. properties donne chaque propriété sous forme de valeur simple (voir entries).
  • {{ data.<step>.entries }} — array of { id, url, title, properties, createdTime, lastEditedTime, inTrash, dataSourceId }. Rechercher des entrées et Entrées créées ou modifiées depuis : les entrées trouvées. properties est indexé par nom de propriété, chaque valeur simplifiée : du texte pour un titre, un texte, une sélection ou un statut ; un nombre ; true/false pour une case à cocher ; les noms séparés par des virgules pour une sélection multiple ; début..fin ou début pour une date ; les identifiants séparés par des virgules pour les personnes et les relations ; les URL séparées par des virgules pour les fichiers.
  • {{ data.<step>.found }} — boolean. Rechercher des entrées, Entrées créées ou modifiées depuis, Recherche : true quand au moins un élément a été trouvé.
  • {{ data.<step>.count }} — number. Le nombre d’éléments rendus ou écrits : entrées, bases, propriétés, blocs ajoutés ou listés, commentaires, personnes, résultats.
  • {{ data.<step>.truncated }} — boolean. Sur les listes : true quand il existait plus d’éléments que le Nombre maximum ne le permettait. Sur Lire le contenu en Markdown : true quand Notion a lui-même coupé la page (pages très longues).
  • {{ data.<step>.cursor }} — string. Entrées créées ou modifiées depuis seulement : l’heure de dernière modification de la dernière entrée rendue, ou Depuis quand rien n’a été trouvé. À repasser comme Depuis au passage suivant quand le workflow tient lui-même sa position.
  • {{ data.<step>.refusedProperties }} — array of string. Créer une entrée, Créer une page dans une base, Mettre à jour les propriétés : les propriétés non écrites (nom inconnu, colonne calculée, nombre illisible, ou title quand la base n’a pas de colonne titre).
  • {{ data.<step>.truncatedChars }} — number. Créer une entrée, Créer une page, Mettre à jour les propriétés : le nombre de caractères coupés dans les valeurs texte au-delà de la limite de Notion (100 fragments de 2 000 caractères par valeur). 0 dans le cas normal.
  • {{ data.<step>.created }} — boolean. Créer une entrée et Créer une page : true quand la page a été créée, false en essai.
  • {{ data.<step>.parentPageId }} — string. Créer une page sous une page seulement : l’identifiant de la page parente.
  • {{ data.<step>.updatedProperties }} — array of string. Mettre à jour les propriétés seulement : les noms des propriétés écrites.
  • {{ data.<step>.properties }} — object or array. Lire une page : les propriétés de la page en valeurs simples, indexées par nom. Lire le schéma : un tableau de { name, type, writable }, une entrée par propriété de la source.
  • {{ data.<step>.dataSourceId }} — string. Lire le schéma seulement : l’identifiant de la source de données lue.
  • {{ data.<step>.databaseId }} — string. Lire le schéma seulement : l’identifiant de la base qui contient la source.
  • {{ data.<step>.title }} — string. Lire le schéma seulement : le titre de la source de données.
  • {{ data.<step>.databases }} — array of { dataSourceId, databaseId, title, url }. Lister les bases seulement : les sources de données partagées avec la connexion, les plus récemment modifiées d’abord.
  • {{ data.<step>.inTrash }} — boolean. Mettre à la corbeille / restaurer seulement : true quand la page a été mise à la corbeille, false quand elle a été restaurée.
  • {{ data.<step>.markdown }} — string. Lire le contenu en Markdown seulement : tout le contenu de la page en Markdown.
  • {{ data.<step>.unreadableBlocks }} — number. Lire le contenu en Markdown seulement : le nombre de blocs que Notion n’a pas su convertir.
  • {{ data.<step>.length }} — number. Lire le contenu en Markdown et Écrire du contenu en Markdown : le nombre de caractères lus ou écrits.
  • {{ data.<step>.mode }} — string. Écrire du contenu en Markdown seulement : append ou replace.
  • {{ data.<step>.appended }} — number. Ajouter des blocs seulement : le nombre de blocs envoyés.
  • {{ data.<step>.skippedBlocks }} — number. Ajouter des blocs seulement : le nombre de paragraphes écartés au-delà des 100 blocs d’un appel.
  • {{ data.<step>.blocks }} — array of { id, type, text, hasChildren }. Lister les blocs seulement : les blocs de premier niveau de la page, avec leur texte brut.
  • {{ data.<step>.text }} — string. Lister les blocs seulement : le texte des blocs listés, un par ligne.
  • {{ data.<step>.commentId }} — string. Commenter seulement : l’identifiant du commentaire, vide en essai.
  • {{ data.<step>.discussionId }} — string. Commenter seulement : l’identifiant de la discussion à laquelle appartient le commentaire.
  • {{ data.<step>.comments }} — array of { id, discussionId, createdTime, authorId, text }. Lister les commentaires seulement : les commentaires de la page.
  • {{ data.<step>.files }} — array. Téléverser les pièces jointes : les fichiers retenus, sous la forme { filename, size, origin, addedByNodeId? } (origin vaut email ou added). Récupérer les fichiers d’une page : les fichiers récupérés, sous la forme { name, source, mime, size, attachmentPosition, deduplicated }, où source vaut property:<nom> ou block:<id>.
  • {{ data.<step>.uploaded }} — number. Téléverser les pièces jointes seulement : le nombre de fichiers réellement envoyés à Notion (0 en essai).
  • {{ data.<step>.attached }} — number. Téléverser les pièces jointes seulement : le nombre de fichiers attachés à la page (0 en essai).
  • {{ data.<step>.skipped }} — array. Téléverser les pièces jointes : les noms des fichiers de plus de 20 Mio, écartés. Récupérer les fichiers d’une page : les fichiers au-delà du dixième, sous la forme { name, url, source, reason }.
  • {{ data.<step>.target }} — string. Opérations sur les fichiers seulement : block (contenu de la page) ou property (une propriété Fichiers).
  • {{ data.<step>.positions }} — array of number. Récupérer les fichiers d’une page seulement : les positions des fichiers récupérés dans les pièces jointes de l’exécution, prêtes pour une étape Rédiger.
  • {{ data.<step>.botId }} — string. Lire le compte de la connexion seulement : l’identifiant de l’utilisateur robot de l’intégration.
  • {{ data.<step>.name }} — string. Lire le compte de la connexion seulement : le nom de l’intégration.
  • {{ data.<step>.workspace }} — string. Lire le compte de la connexion seulement : le nom de l’espace de travail.
  • {{ data.<step>.maxFileBytes }} — number. Lire le compte de la connexion seulement : la taille de fichier maximale acceptée par l’espace de travail, en octets (0 quand Notion ne la donne pas).
  • {{ data.<step>.users }} — array of { id, name, email }. Lister les personnes seulement : les personnes de l’espace de travail (les robots sont écartés).
  • {{ data.<step>.results }} — array of { id, object, title, url, lastEditedTime }. Recherche seulement : les pages ou les bases dont le titre correspond, les plus récemment modifiées d’abord.
  • {{ data.<step>.simulated }} — boolean. true quand une écriture a été décrite au lieu d’être faite (essai). Les lectures, y compris les recherches et requêtes que Notion traite en POST, ne sont jamais simulées.
  • {{ data.<step>.summary }} — string. Le résumé d’une ligne dans la langue du membre, par exemple « Entrée « Dupont — bail » créée. » (avec summaryKey et summaryParams).

Opérations ​

Le nœud demande d’abord une Ressource (resource), puis l’opération propre à cette ressource.

Base de données (resource: dataSource, opération dans dataSourceOperation) ​

  • Rechercher des entrées (query, le défaut). Lit le schéma de la source, puis interroge ses entrées (POST /v1/data_sources/{id}/query), jusqu’au Nombre maximum (limit, de 1 à 500, 50 par défaut). Filtre simple : Filtrer sur la propriété (filterProperty), Condition (filterCondition) et Valeur (filterValue) ; la famille de filtre suit le type de la propriété. Filtre avancé (JSON) (filterJson), rempli, remplace le filtre simple. Trier sur la propriété (sortProperty) et Sens du tri (sortDirection) ; sans propriété de tri, les entrées les plus récemment modifiées viennent d’abord. Publie entries, count, found, pageId, truncated.
  • Entrées créées ou modifiées depuis… (changes). Rend les entrées dont l’heure de dernière modification (ou de création avec Nouvelle entrée seulement) est postérieure à Depuis (since, un instant ISO 8601), de la plus ancienne à la plus récente. Ce qui déclenche (changeType) : any, created ou edited (« modifiée » écarte les entrées jamais modifiées depuis leur création). Publie entries, count, found, cursor, truncated.
  • Créer une entrée (createEntry). Lit le schéma, convertit Titre (title) et Propriétés (properties) selon les types déclarés, puis crée la page dans la source (POST /v1/pages). Contenu (Markdown) (markdown) remplit le corps de la page. Publie page, pageId, url, refusedProperties, truncatedChars, created.
  • Lire le schéma (getSchema). Lit les propriétés de la source avec leur type. Publie dataSourceId, databaseId, title, properties, count.
  • Lister les bases (list). Liste les sources de données partagées avec la connexion (POST /v1/search). Publie databases, count, truncated.

Page (resource: page, opération dans pageOperation) ​

  • Créer une page (create, le défaut). Avec Créer la page… (parentType) à Dans une base de données, elle se comporte exactement comme Créer une entrée. À Sous une page, elle crée une sous-page de Page (page) avec Titre et Contenu (Markdown), et publie en plus parentPageId.
  • Lire une page (get). Lit les propriétés de Page, pas son contenu. Publie page, pageId, url, properties.
  • Mettre à jour les propriétés (update). Lit la page et le schéma de sa source, puis écrit les Propriétés fournies (PATCH /v1/pages/{id}) ; les autres restent inchangées. Publie page, pageId, url, updatedProperties, refusedProperties, truncatedChars.
  • Mettre à la corbeille / restaurer (archive). Avec Mettre à la corbeille (inTrash, coché par défaut), la page part à la corbeille ; décoché, elle est restaurée. Publie pageId, inTrash.
  • Lire le contenu en Markdown (getMarkdown). Rend toute la page en Markdown en un appel, prête pour un nœud IA. Publie pageId, markdown, truncated, unreadableBlocks, length.
  • Écrire du contenu en Markdown (updateMarkdown). Écrit Contenu (Markdown) selon Façon d’écrire (markdownMode) : Ajouter à la fin (le défaut) ou Remplacer tout le contenu. Le remplacement ne supprime jamais les sous-pages et les bases que la page contient. Publie pageId, mode, length.

Bloc (resource: block, opération dans blockOperation) ​

  • Ajouter des blocs (append, le défaut). Découpe Texte (blockText) en blocs de Type de bloc (blockType), une ligne vide séparant deux blocs, et les pose À la fin de la page ou Au début de la page (blockPosition). 100 blocs au plus par appel. Publie pageId, appended, skippedBlocks.
  • Lister les blocs (children). Liste les blocs de premier niveau de Page avec leur texte. Publie pageId, blocks, count, text, truncated.

Commentaire (resource: comment, opération dans commentOperation) ​

  • Commenter (create, le défaut). Publie Commentaire (commentText, Markdown en ligne) sur Page, ou dans la discussion existante indiquée dans Répondre au fil (discussionId). Signer le commentaire (displayName) fixe le nom affiché à côté. Publie pageId, commentId, discussionId.
  • Lister les commentaires (list). Liste les commentaires de Page. Publie pageId, comments, count, truncated.

Fichier (resource: file, opération dans fileOperation) ​

  • Téléverser les pièces jointes (upload, le défaut). Retient des fichiers de l’exécution avec Pièces jointes retenues (selection : toutes, la première, par type de fichier mime, par nom de fichier namePattern), envoie chacun à Notion (POST /v1/file_uploads, puis …/send), puis les attache selon Emplacement (fileTarget) : un bloc fichier par fichier au bas de la page (Le contenu de la page), ou dans une propriété « Fichiers » dont le nom est dans Nom de la propriété (filesProperty), où les fichiers déjà présents sont remplacés. Publie pageId, files, uploaded, attached, skipped, target.
  • Récupérer les fichiers d’une page en pièces jointes (download). Trouve les fichiers de la page, dans ses blocs fichier, PDF, image, vidéo et audio (Le contenu de la page) ou dans ses propriétés Fichiers (Une propriété « Fichiers » ; toutes quand Nom de la propriété est vide), en télécharge 10 au plus, chacun jusqu’à Taille maximale par fichier (Mo) (maxDownloadMb), et les ajoute aux pièces jointes de l’exécution. Publie pageId, target, files, positions, count, skipped.

Utilisateur (resource: user, opération dans userOperation) ​

  • Lister les personnes (list, le défaut). Liste les personnes de l’espace de travail. Publie users, count, truncated.
  • Lire le compte de la connexion (me). Lit le compte propre à l’intégration. Publie botId, name, workspace, maxFileBytes.

Cherche Rechercher (searchQuery) dans les titres de tout ce qui est partagé avec la connexion, parmi Chercher parmi (searchObject) : les pages, les bases de données ou les deux. Publie results, count, found, pageId, truncated.

Chaque opération publie aussi simulated et summary.

Exemple ​

Les demandes envoyées par les clients doivent devenir des entrées d’une base « Demandes ». Une étape Extraire nommée « Extraire la demande » déclare les champs client, ref_dossier et echeance (une date). Le nœud Notion s’appelle « Entrée Notion », ses données vivent donc sous entree_notion :

text
resource             dataSource
dataSourceOperation  createEntry
database             (mode URL) https://www.notion.so/cabinet/Demandes-1a2b3c…
dataSource           (mode liste) Demandes
title                {{ data.extraire_la_demande.client }} — {{ email.subject }}
properties           Reference   → {{ data.extraire_la_demande.ref_dossier }}
                     Echeance    → {{ data.extraire_la_demande.echeance }}
                     Statut      → Nouveau
                     Expediteur  → {{ email.from.email }}
markdown             {{ email.bodyText }}

Chaque valeur est convertie selon le type de la colonne dans Notion : Echeance est une colonne date et reçoit 2026-11-15, Statut une colonne statut et reçoit l’option nommée Nouveau, Expediteur une colonne e-mail. Si un nom de colonne est mal orthographié, l’entrée est quand même créée et le nom apparaît dans refusedProperties. Les données de l’étape :

json
{
  "page": {
    "id": "2f1c9a4e-0b7d-4c55-9e3a-8d1f6b2a7c90",
    "url": "https://www.notion.so/Dupont-Nouvelle-demande-2f1c9a4e0b7d4c559e3a8d1f6b2a7c90",
    "title": "Dupont — Nouvelle demande",
    "properties": { "Reference": "2026-0412", "Echeance": "2026-11-15", "Statut": "Nouveau", "Expediteur": "marie@exemple.fr" },
    "createdTime": "2026-10-04T08:12:00.000Z",
    "lastEditedTime": "2026-10-04T08:12:00.000Z",
    "inTrash": false,
    "dataSourceId": "7e3d…"
  },
  "pageId": "2f1c9a4e-0b7d-4c55-9e3a-8d1f6b2a7c90",
  "url": "https://www.notion.so/Dupont-Nouvelle-demande-2f1c9a4e0b7d4c559e3a8d1f6b2a7c90",
  "refusedProperties": [],
  "truncatedChars": 0,
  "created": true,
  "simulated": false
}

Une étape Rédiger peut envoyer le lien {{ data.entree_notion.url }} à l’équipe, et un nœud Notion suivant peut commenter l’entrée avec Page à {{ data.entree_notion.pageId }}.

Conseils ​

  • Partagez avant d’utiliser. Un integration.not_found sur un identifiant qui semble juste veut presque toujours dire que la page ou la base n’est pas partagée avec la connexion. Le message d’erreur le dit ; ajoutez la connexion depuis le menu ··· de la page, sous Connexions. Une Recherche ou un Lister les bases qui ne rend rien a la même cause.
  • Valeurs des propriétés. Les valeurs sont converties selon le type déclaré : une date en ISO (2026-11-15, ou 2026-11-15..2026-11-20 pour une période), un nombre avec un point ou une virgule, une liste en noms séparés par des virgules, oui, yes, true ou 1 pour une case à cocher, des identifiants d’utilisateurs pour les personnes, des identifiants ou des URL de pages pour les relations, des URL pour les fichiers. Une valeur vide efface la propriété. Les colonnes calculées (formule, agrégation, date de création, identifiant unique…) ne sont jamais écrites et figurent dans refusedProperties.
  • Textes longs. Une propriété texte tient au plus 100 fragments de 2 000 caractères ; au-delà, les caractères coupés sont comptés dans truncatedChars. Pour un corps de mail, préférez Contenu (Markdown), que Notion découpe lui-même en blocs.
  • Noms de propriétés dans les expressions. Une expression n’atteint que des clés faites de lettres, de chiffres, de _ et de $. Une propriété nommée Date limite ne se lit pas avec {{ data.<step>.page.properties.Date limite }} : nommez sans espace ni accent les propriétés que vos workflows lisent, ou lisez l’objet properties entier.
  • Sondage. Placez un déclencheur Planification avant Entrées créées ou modifiées depuis… et passez {{ data.schedule.plannedFor }} comme Depuis : chaque passage ne rapporte que ce qui a bougé depuis le précédent. Pour tenir vous-même la position, rangez cursor dans une table et repassez-le.
  • Plafond des requêtes. Une requête de base ne peut pas rendre plus de 10 000 résultats chez Notion, quel que soit le Nombre maximum ; au-delà, découpez par plage de dates. La Recherche globale ne porte que sur les titres et son index a un léger retard : dans une base, préférez Rechercher des entrées.
  • Taille des téléversements. Les fichiers de plus de 10 Mio (la limite du serveur par fichier envoyé, plus basse que les 20 Mio de Notion) sont écartés avant tout envoi à Notion, et listés dans skipped. Si aucune pièce ne passe la sélection, l’étape échoue avec node_nothing_to_do.
  • Taille des téléchargements. La Taille maximale par fichier (Mo) va de 1 à 10, la limite réelle du serveur par fichier téléchargé ; un fichier plus gros fait échouer l’étape. Les liens de fichiers Notion sont signés et expirent au bout d’une heure : c’est pourquoi le nœud range le fichier dans l’exécution au lieu de rendre son lien.
  • Nouvelles tentatives. Créer une entrée ou une page, ajouter des blocs, commenter et téléverser ne sont pas idempotents : si le moteur retente l’étape après un incident, la page, les blocs, le commentaire ou les fichiers peuvent être créés deux fois. Avant de créer, un Rechercher des entrées sur une clé métier suivi d’une Condition (Si) sur found évite les doublons.
  • Essais. En essai, toutes les lectures partent pour de bon, y compris Rechercher des entrées, la Recherche et Lister les bases. Créations, mises à jour, passages à la corbeille, écritures Markdown, ajouts de blocs, commentaires et téléversements sont seulement décrits : rien n’est écrit, simulated vaut true, et une page créée n’a ni identifiant ni lien.
  • Données du déclencheur. Dans un workflow démarré par un déclencheur Notion, les données du déclencheur vivent sous data.notion. N’y nommez pas ce nœud « Notion » : ses données ne seraient plus joignables que par l’identifiant du nœud.
  • Erreurs. integration.unauthorized : le jeton a été refusé ou révoqué. integration.rejected : Notion a refusé la requête (par exemple un filtre avancé invalide ou une valeur que Notion n’accepte pas pour la propriété). integration.rate_limited et integration.unavailable sont retentées automatiquement : les requêtes sont cadencées à 180 par minute et par connexion, et une réponse 409, 429 ou 5xx a droit à quatre tentatives avant que le moteur ne reprenne l’étape plus tard. node_invalid_param : une valeur obligatoire est vide, ou le filtre avancé n’est pas un JSON valide. Voir Gestion des erreurs.