# Fiche connecteur Notion
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Notion
URL : https://get-bruno.com/features/connectors/notion
Référence texte : https://get-bruno.com/features/connectors/notion/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Organisation du travail
Description : Notion sert à gérer des pages, des bases de données et du contenu structuré dans un espace de travail. Le connecteur permet de rechercher, lire, créer et mettre à jour des pages ou des sources de données, ainsi que d’utiliser les actions liées aux fichiers et les déclencheurs disponibles.
Authentification : OAuth
Présentation : Notion sert à gérer des pages, des bases de données et du contenu structuré dans un espace de travail. Le connecteur permet de rechercher, lire, créer et mettre à jour des pages ou des sources de données, ainsi que d’utiliser les actions liées aux fichiers et les déclencheurs disponibles.
Usage : Lire une page de compte rendu
Exemple de demande : Je veux ouvrir la page « Compte-rendu client Atelier Martin » pour récupérer son contenu et ses propriétés.
Résultat attendu : La page est renvoyée avec ses propriétés et son contenu en markdown, après résolution de son identifiant ou de son titre.
À préciser : Titre ou URL de la page ; Contexte pour la retrouver si besoin
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/notion/actions/search ; https://pipedream.com/apps/notion/actions/retrieve-page
Usage : Créer une ligne dans une base de suivi
Exemple de demande : Je veux ajouter une ligne dans la base « Suivi des demandes » pour le dossier « Catalogue printemps » avec le statut « En cours ».
Résultat attendu : Une nouvelle page ou ligne est créée dans la source de données avec les champs fournis, à condition d’utiliser le schéma exact.
À préciser : Titre ou URL de la base ; Valeurs des champs à renseigner
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/notion/actions/search ; https://pipedream.com/apps/notion/actions/retrieve-database-schema ; https://pipedream.com/apps/notion/actions/create-page-from-database
Limites propres au service : Certaines actions exigent d’abord un identifiant de page ou de source de données, souvent obtenu avec la recherche. Avant de créer, interroger ou mettre à jour une source de données, il faut connaître le schéma exact des colonnes et les valeurs autorisées. L’ajout de contenu à une page et la mise à jour de ses propriétés passent par des actions différentes. La gestion des fichiers suit un flux dédié de téléversement, de finalisation et d’envoi, distinct des pages et des bases.
Vocabulaire français : Ajouter un bloc au parent — Ajoute du contenu Markdown en bas d’une page ou d’un bloc Notion. (https://pipedream.com/apps/notion/actions/append-block)
Vocabulaire français : Finaliser un téléversement de fichier — Termine un téléversement de fichier en mode multipart après l’envoi des parties. (https://pipedream.com/apps/notion/actions/complete-file-upload)
Vocabulaire français : Copier une page depuis un modèle — Duplique une page Notion existante pour créer une nouvelle page avec un nouveau titre. (https://pipedream.com/apps/notion/actions/duplicate-page)
Vocabulaire français : Créer un commentaire — Ajoute un commentaire à une page Notion ou répond à une discussion existante. (https://pipedream.com/apps/notion/actions/create-comment)
Vocabulaire français : Créer une base de données — Crée une nouvelle base Notion sous une page parente en définissant son schéma de colonnes. (https://pipedream.com/apps/notion/actions/create-database)
Vocabulaire français : Créer un téléversement de fichier — Crée un téléversement de fichier pour un flux de fichiers Notion. (https://pipedream.com/apps/notion/actions/create-file-upload)
Vocabulaire français : Créer une page — Crée une page Notion sous une page parente ou dans une base comme nouvelle ligne. (https://pipedream.com/apps/notion/actions/create-page)
Vocabulaire français : Créer une page depuis une source de données — Crée une nouvelle ligne dans une base Notion à partir des valeurs de champs fournies. (https://pipedream.com/apps/notion/actions/create-page-from-database)
Vocabulaire français : Supprimer un bloc — Archive un bloc Notion existant en le marquant comme supprimé. (https://pipedream.com/apps/notion/actions/delete-block)
Vocabulaire français : Obtenir l’utilisateur courant — Récupère l’identité Notion liée au jeton OAuth courant. (https://pipedream.com/apps/notion/actions/get-current-user)
Vocabulaire français : Obtenir une page — Récupère une page Notion avec ses propriétés et son contenu rendu en markdown. (https://pipedream.com/apps/notion/actions/retrieve-page)
Vocabulaire français : Lister tous les utilisateurs — Renvoie tous les utilisateurs du workspace Notion. (https://pipedream.com/apps/notion/actions/list-all-users)
Vocabulaire français : Lister les téléversements de fichiers — Renvoie la liste des téléversements de fichiers Notion. (https://pipedream.com/apps/notion/actions/list-file-uploads)
Vocabulaire français : Interroger une source de données — Filtre et trie les lignes d’une base Notion selon leurs valeurs de propriétés. (https://pipedream.com/apps/notion/actions/query-database)
Vocabulaire français : Récupérer le contenu d’une source de données — Renvoie tout le contenu d’une source de données Notion. (https://pipedream.com/apps/notion/actions/retrieve-database-content)
Vocabulaire français : Récupérer le schéma d’une base de données — Renvoie le schéma des colonnes d’une base Notion et les options autorisées. (https://pipedream.com/apps/notion/actions/retrieve-database-schema)
Vocabulaire français : Récupérer un téléversement de fichier — Récupère un téléversement de fichier Notion existant. (https://pipedream.com/apps/notion/actions/retrieve-file-upload)
Vocabulaire français : Récupérer le contenu d’une page — Récupère le contenu d’une page ou d’un bloc, sous forme de blocs ou de markdown. (https://pipedream.com/apps/notion/actions/retrieve-block)
Vocabulaire français : Récupérer un élément de propriété de page — Récupère un objet Property Item pour une propriété de page donnée. (https://pipedream.com/apps/notion/actions/retrieve-page-property-item)
Vocabulaire français : Récupérer un utilisateur — Renvoie un utilisateur à partir de l’identifiant fourni. (https://pipedream.com/apps/notion/actions/retrieve-user)
Vocabulaire français : Rechercher — Recherche des pages et des bases Notion par titre pour retrouver un identifiant exploitable par les autres outils. (https://pipedream.com/apps/notion/actions/search)
Vocabulaire français : Envoyer un téléversement de fichier — Envoie un téléversement de fichier déjà préparé. (https://pipedream.com/apps/notion/actions/send-file-upload)
Vocabulaire français : Mettre à jour un bloc enfant — Modifie un bloc enfant existant, sans toucher aux propriétés de page ni au schéma. (https://pipedream.com/apps/notion/actions/update-block)
Vocabulaire français : Mettre à jour une source de données — Renomme une base Notion, change sa description ou modifie ses colonnes. (https://pipedream.com/apps/notion/actions/update-database)
Vocabulaire français : Mettre à jour une page — Met à jour les propriétés d’une page Notion et peut aussi l’archiver. (https://pipedream.com/apps/notion/actions/update-page)
Vocabulaire français : Nouveau commentaire créé — Déclenche un événement lorsqu’un nouveau commentaire est créé sur une page ou un bloc. (https://pipedream.com/apps/notion/triggers/new-comment-created)
Vocabulaire français : Nouvelle source de données créée — Déclenche un événement lorsqu’une source de données est créée. (https://pipedream.com/apps/notion/triggers/new-database)
Vocabulaire français : Nouvelle ou mise à jour d’une page dans une source de données par propriété — Déclenche un événement quand une page est créée ou mise à jour dans la base sélectionnée. (https://pipedream.com/apps/notion/triggers/updated-page)
Vocabulaire français : Nouvelle ou mise à jour d’une page dans une source de données par horodatage — Déclenche un événement quand une page est créée ou mise à jour dans la base sélectionnée. (https://pipedream.com/apps/notion/triggers/updated-page-by-timestamp)
Vocabulaire français : Nouvelle page dans une source de données — Déclenche un événement lorsqu’une page est créée dans la base sélectionnée. (https://pipedream.com/apps/notion/triggers/new-page)
Vocabulaire français : Nouvel événement de webhook instantané — Déclenche un événement à chaque réception d’un webhook configuré dans Notion. (https://pipedream.com/apps/notion/triggers/new-webhook-event-instant)
Vocabulaire français : Page ou sous-page mise à jour — Déclenche un événement quand la page sélectionnée ou une sous-page est mise à jour. (https://pipedream.com/apps/notion/triggers/page-or-subpage-updated)
Vocabulaire français : Propriétés de page mises à jour instantanément — Déclenche un événement à chaque mise à jour de propriété de page dans une source de données. (https://pipedream.com/apps/notion/triggers/page-properties-updated-instant)
Vocabulaire français : Page mise à jour — Déclenche un événement lorsqu’une page sélectionnée est mise à jour. (https://pipedream.com/apps/notion/triggers/updated-page-id)
- action : Append Block to Parent — Append Markdown content to the bottom of a Notion page (or block). The content is parsed from Markdown into Notion blocks — use it to add paragraphs, headings, bullet/numbered lists, to-dos, quotes, code, etc. Provide the page ID or URL (use Search to resolve a page name into an ID). To change a database row's property values instead, use Update Page . See the documentation (https://pipedream.com/apps/notion/actions/append-block)
- action : Complete File Upload — Use this action to finalize a mode=multi_part file upload after all of the parts have been sent successfully. See the documentation (https://pipedream.com/apps/notion/actions/complete-file-upload)
- action : Copy Page From Template — Copy an EXISTING page (template) into a new page with a new title. Use this ONLY when the user is reusing the structure of an existing page as a template (e.g. "copy this offer letter template for a new candidate"). Do NOT use to create a new page with original content — for that, use Create Page . The source page must already exist in Notion and is identified by its page ID. See the documentation (https://pipedream.com/apps/notion/actions/duplicate-page)
- action : Create Comment — Add a comment to a Notion page, or reply to an existing discussion thread. Provide either a page ID/URL (use Search to resolve a page name) or a discussion ID — not both. See the documentation (https://pipedream.com/apps/notion/actions/create-comment)
- action : Create Database — Create a new Notion database (data source) as a subpage of a parent page, defining its column schema. Provide the parent page ID or URL (use Search to resolve a page name into an ID). properties is a JSON object of column-name → column type. Each value is a property schema object, or shorthand for simple types: { "Name": "title", "Quantity": "number", "Category": { "select": { "options": [ { "name": "A" }, { "name": "B" } ] } } } . Exactly one column must be the title type. See the documentation (https://pipedream.com/apps/notion/actions/create-database)
- action : Create File Upload — Create a file upload. See the documentation (https://pipedream.com/apps/notion/actions/create-file-upload)
- action : Create Page — Create a new Notion page. The parent can be either another page (creates a subpage) or a database/data source (creates a row in that database). Provide the parent's ID or URL — use Search to resolve a name into an ID. When the parent is a database, set properties to a flat JSON object of column-name → value (e.g. { "Status": "Active", "ThreatLevel": 9 } ); call Retrieve Database Schema first to learn the exact column names and valid select options. content is the page body as Markdown (headings, bullet lists, paragraphs, etc.). See the documentation (https://pipedream.com/apps/notion/actions/create-page)
- action : Create Page from Data Source — Create a new page (row) in a Notion data source (database). Provide the parent data source ID and the row's field values as a JSON object keyed by column name. Use the Search action (with filter: data_source ) to resolve a database name into its data source ID, and Retrieve Database Schema to learn the exact column names and types before setting values. Optionally add page body content with Page Content (Markdown). Example: parentDataSource "a1b2c3d4-..." with properties { "Name": "Q1 Report", "Status": "In Progress", "Tags": ["finance"] } → creates a new row with those fields and returns the created page object. See the documentation (https://pipedream.com/apps/notion/actions/create-page-from-database)
- action : Delete Block — Sets a Block object, including page blocks, to archived: true using the ID specified. Example: blockId "1a2b3c4d-..." → archives that block and returns the block object with archived: true . See the documentation (https://pipedream.com/apps/notion/actions/delete-block)
- action : Get Current User — Retrieve the Notion identity tied to the current OAuth token, returning the full users.retrieve payload for me (person or bot). Includes the user ID, name, avatar URL, type ( person vs bot ), and workspace ownership metadata—useful for confirming which workspace is connected, adapting downstream queries, or giving an LLM the context it needs about who is operating inside Notion. See the documentation. (https://pipedream.com/apps/notion/actions/get-current-user)
- action : Get Page — Retrieve a Notion page: both its property values and its body content rendered as Markdown. Use this to read what a page says or to inspect a database row's fields. Provide a page ID or a Notion page URL (use Search to resolve a page name into an ID). See the documentation (https://pipedream.com/apps/notion/actions/retrieve-page)
- action : List All Users — Returns all users in the workspace. See the documentation (https://pipedream.com/apps/notion/actions/list-all-users)
- action : List File Uploads — Use this action to list file uploads. See the documentation (https://pipedream.com/apps/notion/actions/list-file-uploads)
- action : Query Data Source — Filter and sort the pages (rows) inside a Notion database (data source) by their property values. Discover exact property names and option values with Retrieve Database Schema first , then build a filter against them. A filter is a JSON object: a single condition { "property": "Status", "select": { "equals": "Escaped" } } , or a compound { "and": [ ... ] } / { "or": [ ... ] } . The condition key matches the property type — e.g. select , status , multi_select , number ( { "greater_than": 5 } ), checkbox ( { "equals": true } ), rich_text / title ( { "contains": "..." } ), date . Omit filter to return all rows. Provide the data source ID (use Search with filter: data_source to resolve a database name). See the documentation (https://pipedream.com/apps/notion/actions/query-database)
- action : Retrieve Data Source Content — Get all content of a data source. See the documentation (https://pipedream.com/apps/notion/actions/retrieve-database-content)
- action : Retrieve Database Schema — Get the column (property) schema of a Notion database (data source): each property's name, type, and — for select / multi_select / status columns — its allowed option values. Call this before Query Data Source, Create Page, or Update Page on a database so you use exact property names and valid option values. Provide the data source ID (use Search with filter: data_source to resolve a database name into its ID). See the documentation (https://pipedream.com/apps/notion/actions/retrieve-database-schema)
- action : Retrieve File Upload — Use this action to retrieve a file upload. See the documentation (https://pipedream.com/apps/notion/actions/retrieve-file-upload)
- action : Retrieve Page Content — Get page content as block objects or markdown. Blocks can be text, lists, media, a page, among others. Example: blockId "1a2b3c4d-..." with Retrieve Children set to All Children and Retrieve as Markdown enabled → returns the block with its nested children array plus a markdownContent string of the page text. See the documentation (https://pipedream.com/apps/notion/actions/retrieve-block)
- action : Retrieve Page Property Item — Get a Property Item object for a selected page and property. See the documentation (https://pipedream.com/apps/notion/actions/retrieve-page-property-item)
- action : Retrieve User — Returns a user using the ID specified. See the documentation (https://pipedream.com/apps/notion/actions/retrieve-user)
- action : Search — Search Notion for pages and databases (data sources) by title. Use this first to resolve a page or database name into an ID that the other Notion tools require (e.g. Query Data Source , Retrieve Database Schema , Get Page , Create Page ). Leave query blank to list everything the integration can access. Set filter to data_source to find databases or page to find pages — on the current Notion API a database is returned as a data_source object, and its id is the data source ID you pass to the database tools. See the documentation (https://pipedream.com/apps/notion/actions/search)
- action : Send File Upload — Send a file upload. See the documentation (https://pipedream.com/apps/notion/actions/send-file-upload)
- action : Update Child Block — Update a single existing child block (paragraph, heading, to-do, code, etc.) by its block ID. Use this only to mutate an existing block in place. Do NOT use to update a page's properties (database row fields) — use Update Page instead. Do NOT use to add new content to a page — use Append Block to Parent instead. Do NOT use to update a database's schema — use Update Data Source instead. See the documentation (https://pipedream.com/apps/notion/actions/update-block)
- action : Update Data Source — Update a Notion database (data source): rename it, change its description, or add/rename/retype its columns. Provide the data source ID (use Search with filter: data_source to resolve a database name, or Retrieve Database Schema to inspect existing columns). properties is a JSON object of changes: to add a column, use a new name → type (e.g. { "Location": "rich_text" } ); to rename/retype an existing column, key it by its current name/ID. Each value is a property schema object or a shorthand type name. See the documentation (https://pipedream.com/apps/notion/actions/update-database)
- action : Update Page — Update a Notion page's property values, and/or archive (delete) it. Properties you don't include are left unchanged. Provide the page ID or URL (use Search or Query Data Source to find it). Set properties to a flat JSON object of column-name → value, e.g. { "Status": "Contained" } ; call Retrieve Database Schema first to learn the exact column names and valid select options. To add body content instead of changing properties, use Append Block to Parent . See the documentation (https://pipedream.com/apps/notion/actions/update-page)
- trigger : New Comment Created — Emit new event when a new comment is created in a page or block. See the documentation (https://pipedream.com/apps/notion/triggers/new-comment-created)
- trigger : New Data Source Created — Emit new event when a data source is created. See the documentation (https://pipedream.com/apps/notion/triggers/new-database)
- trigger : New or Updated Page in Data Source (By Property) — Emit new event when a page is created or updated in the selected data source. See the documentation (https://pipedream.com/apps/notion/triggers/updated-page)
- trigger : New or Updated Page in Data Source (By Timestamp) — Emit new event when a page is created or updated in the selected data source. See the documentation (https://pipedream.com/apps/notion/triggers/updated-page-by-timestamp)
- trigger : New Page in Data Source — Emit new event when a page is created in the selected data source. See the documentation (https://pipedream.com/apps/notion/triggers/new-page)
- trigger : New Webhook Event (Instant) — Emit new event each time a webhook event is received. Webhook must be setup in Notion. See the documentation (https://pipedream.com/apps/notion/triggers/new-webhook-event-instant)
- trigger : Page or Subpage Updated — Emit new event when the selected page or one of its sub-pages is updated. See the documentation (https://pipedream.com/apps/notion/triggers/page-or-subpage-updated)
- trigger : Page Properties Updated (Instant) — Emit new event each time a page property is updated in a data source. For use with Page Properties Updated event type. Webhook must be set up in Notion. See the documentation (https://pipedream.com/apps/notion/triggers/page-properties-updated-instant)
- trigger : Page Updated — Emit new event when a selected page is updated. See the documentation (https://pipedream.com/apps/notion/triggers/updated-page-id)