Notion API : Le guide complet (mise à jour 2021)

Dans cet article, je vous explique simplement comment est-ce qu'on peut utiliser l'API de Notion sans savoir coder.

Parce que oui il est maintenant possible de connecter des centaines de logiciels avec Notion, comme Typeform, Webflow ou encore Gmail. Cet article est un guide complet pour démarrer avec l'API de Notion.

L’API est sortie officiellement le 13 Mai 2021. J’ai d’ailleurs fait un live lors de la sortie qui a été suivie par des centaines de personnes. Vous le retrouvez à la fin de cet article.

Cette API est présentée comme étant pour les développeurs initialement, or la réalité c'est que nous, même non-développeurs, on peut très facilement l'utiliser.

Qu'est-ce qu'une API ?

Une API est une fonctionnalité d'un logiciel qui permet de les connecter à d'autres logiciels afin d'échanger des données. Cela permet d'accroître le nombre d'utilisation du logiciel source.

Je vous donne un exemple : Uber a intégré l'API de Spotify afin de donner la possibilité à ses utilisateurs d'écouter la même musique pendant une courte Uber que dans son téléphone.

Dans le cas de Notion, cette fonctionnalité permettra de connecter Notion à plein d'autres logiciels.

Est-ce qu'il faut absolument être un développeur pour l'utiliser ?

Oui il faut avoir quelques connaissances techniques pour se servir d'une API. Mais ce qui est génial, c'est qu'une fois que l'API est disponible d'autres développeurs peuvent s'en emparer et faire le travail une fois et nous (non-développeurs) nous pouvons utiliser la connexion sans toucher à une seule ligne de code.

C'est la magie des APIs, elles sont partout c'est juste qu'elles sont invisibles pour nous. Si ce sujet vous intéresse j'ai fait une présentation sur comment utiliser l'API de Notion en NoCode.

Quel est l'impact de l'API sur Notion ?

C'est simple, avant cette sortie, c'était impossible de pouvoir connecter Notion avec d'autres applications. Enfin quand je dis impossible, mais il y avait une technique qui était Notion Automations. Mais voilà ce n'était pas forcément évident. Il fallait passer par Zapier, qui est un logiciel NoCode.

Alors que là on arrive à connecter Notion avec des centaines de logiciels sans forcément passer par un logiciel externe. Le meilleur exemple c'est Typeform qui ont construit une intégration native avec Notion.

Dans la deuxième partie de cet article, il y a un tuto pas à pas pour connecter Typeform à Notion. Le but est de créer un workflow pour que dès qu'on remplit un formulaire Typeform, les réponses arrivent dans Notion.

Les nouvelles intégrations de Notion via la nouvelle API

Typeform ont été les premiers à faire une intégration native, Tally en ont fait une également et on va en avoir de plus en plus.

Zapier ont également sorti leur intégration Notion : elle permet de connecter Notion à Google Sheets, Facebook, Slack etc. Ça donne accès à un répertoire de plus de 2000 applications qui peuvent être connectées.

Automate.io ça faisait un moment qu'ils travaillaient dessus et il existe maintenant leur intégration avec Notion. Dans le même état d'esprit que Zapier, Automate.io permet de connecter Notion à plein d'applications existantes.

Il y a aussi Notion Automations qui sort une nouvelle version dans laquelle on va pouvoir connecter nativement Google Agenda et Notion. Ça veut dire que vous allez pouvoir automatiquement synchroniser dans les deux sens Google Agenda & Notion.

Évidemment il y a plein de nouvelles intégrations et cas d'usages qui vont arriver. Mais ce qui va nous intéresser ici pour ce guide, c'est l'intégration Typeform - Notion.

Connecter Notion avec Typeform

Ici on veut pouvoir connecter Notion avec Typeform afin d'avoir nos réponses de formulaires sur Notion directement. Dans un premier temps je vais sur Typeform et dans la page des intégrations je vais pouvoir ajouter notion en tant que connexion.

Ici aussi Merci aux développeurs de Typeform qui ont créé cette intégration grâce à l'API de Notion, car pour nous c'est invisible.

Et là il me donne la possibilité d'authentifier mon compte Typeform, puis mon compte Notion.

Ce qu'il se passe, c'est que les deux font la connexion pour pouvoir communiquer ensemble. Et je vais devoir sélectionner la page que je veux utiliser : là par exemple je vais utiliser "ma base" et je lui donne donc l'accès à cette base.

Là on voit ce qu’on appelle "Maper les champs", c’est-à-dire qu’on va dire à l’API quel est le champ dans mon formulaire qui va se connecter avec le champ dans ma base de données Notion.

C'est un formulaire assez classique avec un nom, un email, un nom de l'entreprise et un rôle.

Je veux que les réponses à la question "Full name" aillent directement dans le champ "Name" et quand on demande par exemple l'email, que ça aille dans le champ Email.

Je dois pour cela avoir une propriété de type email. Ensuite il faut cliquer sur Save Mapping, puis on peut tester l'intégration.

Voilà j'ai donc mon formulaire typeform connecté avec Notion (via l'API)

Donc maintenant si je vais dans mon formulaire remplir une entrée, elle se retrouve dans "ma base". Ces deux éléments sont très rapidement connectés, sans aucune intervention technique notre part.

L'API de Notion nous permet de faire ça, que vous soyez développeurs ou non.

Je vous propose de regarder la vidéo qui montre cette manipulation pas à pas

Pour ceux qui veulent aller plus loin.

J'ai fait un workshop sur l'API Notion, vu que les API sont des choses qui me passionnent depuis longtemps. J'ai fait un tour complet des bases, comment est-ce que ça fonctionnait, comment est ce qu'on pouvait les utiliser, comment est ce qu'on pouvait créer une intégration directement avec Notion sans forcément coder, et essayer de comprendre ce qui était possible et pas possible.

C'est un webinar d'une heure qui a fait plus de 500 inscrits en moins de quelques jours. Je vous invite à le voir si jamais ça vous intéresse.