Notion API : automatiser son workflow avec l’API officielle et Zapier

Notion a longtemps souffert de son manque d’intégrations natives. Depuis le lancement de l’API officielle en 2021 et son amélioration continue, la situation a radicalement changé. Aujourd’hui, les utilisateurs avancés automatisent la création de pages, la mise à jour de bases de données et la synchronisation avec des dizaines d’outils tiers. Lucas Martin, développeur habitué aux intégrations techniques, vous guide dans les possibilités réelles de l’API Notion.

Qu’est-ce que l’API Notion ?

L’API Notion est une interface REST qui permet à des applications externes de lire et modifier votre contenu Notion. Concrètement, vous pouvez :

• Créer des pages ou des entrées de base de données automatiquement
• Lire le contenu d’une page ou d’une base de données
• Mettre à jour des propriétés (statuts, dates, textes)
• Ajouter des blocs de contenu dans une page existante
• Rechercher dans votre workspace

Ce qui n’est pas encore possible via l’API : les commentaires inline, certains types de blocs (synced blocks, colonnes), et les permissions granulaires.

Prérequis : créer une intégration Notion

Étape 1 : Créer l’intégration

1. Accédez à notion.so/my-integrations
2. Cliquez « New integration »
3. Nommez-la (ex. « Mon Zapier ») et sélectionnez votre workspace
4. Copiez le Integration Token (commence par secret_)

Étape 2 : Connecter l’intégration à vos pages

L’API Notion est opt-in par page. Pour chaque page ou base de données que vous souhaitez exposer :

• Ouvrez la page dans Notion
• Cliquez sur les trois points (…) → Connections
• Activez votre intégration

Sans cette étape, l’API retournera une erreur 404 même avec un token valide.

Automatisation sans code : Zapier et Make

Zapier

Zapier propose une intégration Notion native avec les actions les plus courantes :

Triggers disponibles :

• New database item → déclenche quand une nouvelle ligne est ajoutée
• Updated database item → déclenche quand une propriété change

Actions disponibles :

• Create page → crée une nouvelle entrée de base de données
• Update page → met à jour des propriétés d’une page existante
• Find database item → recherche une entrée existante

Exemples de Zaps utiles :

1. Formulaire Typeform → Notion : quand un prospect remplit votre formulaire de contact, une fiche est créée automatiquement dans votre CRM Notion avec toutes les informations saisies.

2. Email Gmail → Notion : filtrez les emails avec un label spécifique (ex. « À archiver Notion ») et créez automatiquement une entrée dans votre base de données d’informations importantes.

3. Calendly → Notion : quand un RDV est réservé, créez une tâche dans votre base de données avec la date, le nom et les notes de préparation.

4. Notion status changé → Notification Slack : quand le statut d’un projet passe à « Livré », envoyez une notification dans le canal Slack de l’équipe.

Make (ex-Integromat)

Make offre une flexibilité supérieure à Zapier pour les workflows complexes. Points forts :

• Itération sur des collections (traiter chaque ligne d’une base de données)
• Conditions et filtres avancés
• Gestion d’erreurs et relances
• Coût généralement inférieur pour les volumes importants

Make supporte également les webhooks, ce qui permet à des applications tierces d’envoyer des données vers Notion en temps réel.

Automatisation avec code : l’API REST directement

Pour les développeurs, l’API Notion est une API REST standard. Voici les bases en Python avec la librairie officielle notion-client.

Installation

pip install notion-client

Connexion et lecture d’une base de données

from notion_client import Client

notion = Client(auth="secret_votre_token_ici")

# Lire une base de données
results = notion.databases.query(
    database_id="votre_database_id"
)

for page in results["results"]:
    title = page["properties"]["Name"]["title"]
    if title:
        print(title[0]["plain_text"])

Créer une entrée dans une base de données

notion.pages.create(
    parent={"database_id": "votre_database_id"},
    properties={
        "Name": {
            "title": [{"text": {"content": "Nouvelle tâche"}}]
        },
        "Status": {
            "select": {"name": "À faire"}
        },
        "Date": {
            "date": {"start": "2025-06-15"}
        }
    }
)

Mettre à jour une page existante

notion.pages.update(
    page_id="votre_page_id",
    properties={
        "Status": {
            "select": {"name": "Terminé"}
        }
    }
)

Cas d’usage avancés

Synchronisation bidirectionnelle avec Google Sheets

Un pattern populaire consiste à synchroniser une base de données Notion avec Google Sheets :

• Notion → Sheets : export régulier pour analyses et rapports (Google Sheets est plus puissant pour les formules complexes et les graphiques)
• Sheets → Notion : mise à jour en masse de propriétés après traitement

Ce flux hybride exploite les forces de chaque outil.

Création automatique de rapports hebdomadaires

Script Python exécuté chaque vendredi qui :

1. Interroge la base de données des tâches de la semaine
2. Filtre par statut « Terminé » avec date dans les 7 derniers jours
3. Crée une nouvelle page « Rapport semaine X » dans votre journal
4. Y insère la liste des tâches accomplies et un résumé

Intégration GitHub Issues → Notion

Pour les développeurs utilisant Notion pour le suivi de projet :

• Un webhook GitHub envoie les nouvelles issues vers Make
• Make crée l’entrée correspondante dans votre Notion Board
• Quand l’issue est fermée sur GitHub, Make met à jour le statut dans Notion

Limites et considérations importantes

Rate limiting

L’API Notion limite les requêtes à 3 par seconde. Pour des scripts traitant beaucoup d’entrées, implémentez des délais entre les requêtes :

import time
time.sleep(0.4)  # 400ms entre chaque requête

Taille des blocs

L’API limite la taille du contenu d’un bloc de texte à 2000 caractères. Pour du contenu long, découpez-le en plusieurs blocs.

Pas de temps réel natif

L’API Notion ne supporte pas les webhooks natifs (contrairement à Airtable par exemple). Pour simuler du temps réel, vous devez soit utiliser Make/Zapier qui gèrent le polling, soit mettre en place un polling manuel dans votre script.

Données sensibles

Comme pour toute API, ne stockez jamais votre Integration Token en dur dans votre code. Utilisez des variables d’environnement ou un gestionnaire de secrets.

Par où commencer ?

Si vous n’avez jamais utilisé l’API Notion :

1. Commencez par un Zap simple (Typeform → Notion ou Gmail → Notion) pour comprendre la mécanique
2. Explorez la documentation officielle sur developers.notion.com — elle est bien faite avec des exemples
3. Pour le code, partez du SDK Python officiel et testez d’abord en lecture avant d’écrire
4. Rejoignez la communauté Notion sur Reddit (r/Notion) — de nombreux développeurs partagent leurs intégrations

Conclusion

L’API Notion ouvre des possibilités considérables pour les utilisateurs qui souhaitent sortir du « saisie manuelle » et automatiser leurs workflows. Que vous passiez par Zapier pour des automatisations simples sans code, ou que vous développiez des scripts Python pour des intégrations complexes, Notion devient le hub de données central de votre système de productivité. L’investissement en apprentissage est rapidement rentabilisé par le temps gagné sur les tâches répétitives.

Commencez avec Notion et explorez les intégrations disponibles dans votre tableau de bord.

A propos de l'auteur

Maxime Berger

Coach en productivite et specialiste Notion

Maxime Berger est coach en productivite et consultant Notion certifie depuis 7 ans. Ancien Product Manager chez Alan, il a forme plus de 500 professionnels aux methodes de travail efficaces. Il partage templates et strategies sur guide-productivite.com.

400 articles publiésVoir le profil →