# Fiche connecteur Notion (API Key)
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 (API Key)
URL : https://get-bruno.com/features/connectors/notion-api-key
Référence texte : https://get-bruno.com/features/connectors/notion-api-key/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Organisation du travail
Description : Notion est un espace de travail qui regroupe des pages, des bases de données et des commentaires dans un même environnement. Ce connecteur expose des opérations pour rechercher, lire, créer et mettre à jour des contenus Notion, ainsi que des déclencheurs documentaires sur les pages et les bases de données.
Authentification : API key
Présentation : Notion est un espace de travail qui regroupe des pages, des bases de données et des commentaires dans un même environnement. Ce connecteur expose des opérations pour rechercher, lire, créer et mettre à jour des contenus Notion, ainsi que des déclencheurs documentaires sur les pages et les bases de données.
Usage : Retrouver une page client puis lire son contenu
Exemple de demande : Je veux retrouver la page Atelier Martin dans Notion, puis lire son contenu pour vérifier le compte-rendu client.
Résultat attendu : La page correspondante est retrouvée si elle existe, puis son contenu est renvoyé sous forme de blocs ou de texte.
À préciser : Le nom exact ou un identifiant de la page Atelier Martin ; Le contexte de recherche attendu, par exemple une base de données ou un espace de travail
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/notion-api-key/actions/search ; https://pipedream.com/apps/notion-api-key/actions/retrieve-block
Usage : Créer une page de suivi dans une base de données
Exemple de demande : Je veux créer une fiche pour le dossier Projet Orion dans ma base de données Notion.
Résultat attendu : Une nouvelle page est créée à partir de la base de données choisie, avec les propriétés fournies au départ.
À préciser : Le nom de la base de données cible ; Les valeurs à inscrire, par exemple titre, statut et responsable pour Projet Orion
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/notion-api-key/actions/create-page-from-database
Usage : Mettre à jour les propriétés d'une fiche puis ajouter une note
Exemple de demande : Je veux mettre à jour la fiche Atelier Martin avec un nouveau statut, puis ajouter une note de suivi dans la page.
Résultat attendu : Les propriétés de la page sont mises à jour, puis un bloc de contenu peut être ajouté en complément.
À préciser : La page cible à modifier ; Les propriétés à changer, par exemple statut ou date de suivi ; Le texte exact de la note à ajouter
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/notion-api-key/actions/update-page ; https://pipedream.com/apps/notion-api-key/actions/append-block
Limites propres au service : La recherche et la lecture dépendent de l'accès aux pages ou aux bases de données visées. Pour ajouter du contenu dans une page, il faut utiliser l'action d'ajout de blocs, pas la mise à jour de propriétés. Les déclencheurs documentent des événements Notion, mais ils ne sont pas des actions à exécuter depuis Bruno. Le schéma d'une base de données peut devoir être consulté avant de préparer des écritures fiables.
Vocabulaire français : Ajouter des blocs à un parent — Ajoute un ou plusieurs blocs au parent indiqué, pour insérer du contenu dans une page ou une section existante. (https://pipedream.com/apps/notion-api-key/actions/append-block)
Vocabulaire français : Créer un commentaire — Crée un commentaire dans une page ou dans un fil de discussion déjà existant. (https://pipedream.com/apps/notion-api-key/actions/create-comment)
Vocabulaire français : Créer une page — Crée une page enfant à partir d'une page parente. (https://pipedream.com/apps/notion-api-key/actions/create-page)
Vocabulaire français : Créer une page depuis une base de données — Crée une page dans une base de données à partir des propriétés fournies. (https://pipedream.com/apps/notion-api-key/actions/create-page-from-database)
Vocabulaire français : Dupliquer une page — Crée une nouvelle page copiée depuis une page existante. (https://pipedream.com/apps/notion-api-key/actions/duplicate-page)
Vocabulaire français : Trouver des pages ou des bases de données — Recherche une page ou une base de données Notion à partir d'un critère de recherche. (https://pipedream.com/apps/notion-api-key/actions/search)
Vocabulaire français : Interroger une base de données — Filtre une base de données avec des critères précisés. (https://pipedream.com/apps/notion-api-key/actions/query-database)
Vocabulaire français : Récupérer le contenu d'une base de données — Renvoie l'ensemble du contenu d'une base de données. (https://pipedream.com/apps/notion-api-key/actions/retrieve-database-content)
Vocabulaire français : Récupérer le schéma d'une base de données — Récupère le schéma des propriétés d'une base de données Notion. (https://pipedream.com/apps/notion-api-key/actions/retrieve-database-schema)
Vocabulaire français : Récupérer le contenu d'une page — Renvoie le contenu d'une page sous forme de blocs ou de texte en markdown. (https://pipedream.com/apps/notion-api-key/actions/retrieve-block)
Vocabulaire français : Récupérer les métadonnées d'une page — Renvoie les détails descriptifs d'une page. (https://pipedream.com/apps/notion-api-key/actions/retrieve-page)
Vocabulaire français : Récupérer un élément de propriété de page — Renvoie l'objet d'une propriété précise pour une page donnée. (https://pipedream.com/apps/notion-api-key/actions/retrieve-page-property-item)
Vocabulaire français : Mettre à jour une page — Met à jour les valeurs de propriété d'une page existante. (https://pipedream.com/apps/notion-api-key/actions/update-page)
Vocabulaire français : Nouveau commentaire créé — Déclenche un événement quand un nouveau commentaire est créé dans une page ou un bloc. (https://pipedream.com/apps/notion-api-key/triggers/new-comment-created)
Vocabulaire français : Nouvelle base de données créée — Déclenche un événement quand une base de données est créée. (https://pipedream.com/apps/notion-api-key/triggers/new-database)
Vocabulaire français : Nouvelle page ou page mise à jour dans une base de données, par propriété — Déclenche un événement quand une page est créée ou modifiée dans la base de données sélectionnée selon une propriété choisie. (https://pipedream.com/apps/notion-api-key/triggers/updated-page)
Vocabulaire français : Nouvelle page dans une base de données — Déclenche un événement quand une page est créée dans la base de données sélectionnée. (https://pipedream.com/apps/notion-api-key/triggers/new-page)
Vocabulaire français : Page ou sous-page mise à jour — Déclenche un événement quand la page choisie ou l'une de ses sous-pages est modifiée. (https://pipedream.com/apps/notion-api-key/triggers/page-or-subpage-updated)
Vocabulaire français : Page mise à jour — Déclenche un événement quand la page sélectionnée est modifiée. (https://pipedream.com/apps/notion-api-key/triggers/updated-page-id)
- action : Append Block to Parent — Append new and/or existing blocks to the specified parent. See the documentation (https://pipedream.com/apps/notion-api-key/actions/append-block)
- action : Create Comment — Create a comment in a page or existing discussion thread. See the documentation (https://pipedream.com/apps/notion-api-key/actions/create-comment)
- action : Create Page — Create a page from a parent page. See the documentation (https://pipedream.com/apps/notion-api-key/actions/create-page)
- action : Create Page from Data Source — Create a page from a data source. See the documentation (https://pipedream.com/apps/notion-api-key/actions/create-page-from-database)
- action : Duplicate Page — Create a new page copied from an existing page block. See the documentation (https://pipedream.com/apps/notion-api-key/actions/duplicate-page)
- action : Find Pages or Data Sources — Searches for a page or data source. See the documentation (https://pipedream.com/apps/notion-api-key/actions/search)
- action : Query Data Source — Query a data source with a specified filter. See the documentation (https://pipedream.com/apps/notion-api-key/actions/query-database)
- action : Retrieve Data Source Content — Get all content of a data source. See the documentation (https://pipedream.com/apps/notion-api-key/actions/retrieve-database-content)
- action : Retrieve Data Source Schema — Get the property schema of a data source in Notion. See the documentation (https://pipedream.com/apps/notion-api-key/actions/retrieve-database-schema)
- action : Retrieve Page Content — Get page content as block objects or markdown. Blocks can be text, lists, media, a page, among others. See the documentation (https://pipedream.com/apps/notion-api-key/actions/retrieve-block)
- action : Retrieve Page Metadata — Get details of a page. See the documentation (https://pipedream.com/apps/notion-api-key/actions/retrieve-page)
- action : Retrieve Page Property Item — Get a Property Item object for a selected page and property. See the documentation (https://pipedream.com/apps/notion-api-key/actions/retrieve-page-property-item)
- action : Update Page — Update a page's property values. To append page content, use the Append Block action instead. See the documentation (https://pipedream.com/apps/notion-api-key/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-api-key/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-api-key/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-api-key/triggers/updated-page)
- 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-api-key/triggers/new-page)
- 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-api-key/triggers/page-or-subpage-updated)
- trigger : Page Updated — Emit new event when a selected page is updated. See the documentation (https://pipedream.com/apps/notion-api-key/triggers/updated-page-id)