Connexions API de Notion

Consultez notre espace pour les développeurs pour obtenir de la documentation, des ressources et des outils de gestion des connexions.

1. Depuis la barre latérale gauche, cliquez sur Paramètres, puis sur l’onglet Connexions.

2. Seuls les propriétaires de l’espace de travail pourront accéder à l’onglet Connexions et créer des intégrations. Si ce n’est pas votre cas, contactez votre administrateur d’espace de travail ou utilisez un autre espace.

3. Cliquez sur le lien Développer vos propres connexions en bas.

4. Mes connexions s’ouvriront dans votre navigateur par défaut. Cliquez sur le bouton + Nouvelle connexion .

5. Donnez un nom à votre connexion. Vous pouvez également importer une image pour le logo.

6. Dans le menu déroulant, choisissez l’Espace de travail associé à cette connexion.

   

   Remarque : vérifiez que vous utilisez le même compte Notion sur votre session Web et votre application de bureau. Sinon, les comptes et espaces de travail que vous aurez sous les yeux ne seront pas les bons !

   

7. Votre connexion interne a été ajoutée avec succès ! Vous la verrez désormais dans votre espace de travail, dans le menu Paramètres  → Connexions.

8. Cliquez sur ••• à côté de la connexion interne pour récupérer le jeton de connexion interne. Il sera nécessaire pour toutes les automatisations que vous développerez avec l’API, et vous permettra de relier votre espace de travail à des plateformes partenaires.

Toutes les connexions nouvellement ajoutées sont initialement internes. Si vous êtes un·e développeur·reuse travaillant sur une connexion publique, suivez d’abord les instructions ci-dessus pour créer une connexion interne.

Ensuite, suivez les instructions de notre guide du/de la développeur·reuse pour la convertir en connexion publique.

Pendant le processus de configuration de l’application, les développeurs pourront choisir le niveau d’accès qui sera demandé à l’utilisateur.

• Autorisations en matière de contenu :

  • Contenu en lecture seule

  • Contenu en écriture seule

  • Insérer du contenu

• Autorisations de l’utilisateur

  • Aucune information d’utilisateur

  • Consulter les informations des utilisateurs (hors adresses e‑mail).

  • Consulter les informations des utilisateurs, notamment les adresses e‑mail

Ce niveau d’accès s’affiche lorsque les utilisateur·rices installent des connexions. Il apparaît aussi dans le menu Partager de toutes les page auxquelles la connexion a été ajoutée. En savoir plus sur l’installation de connexions dans un espace de travail →

Les webhooks de connexion permettent aux connexions de surveiller et de répondre aux modifications apportées aux espaces de travail Notion en temps réel.

Lorsque des modifications sont apportées à des pages ou des bases de données partagées avec votre connexion, Notion envoie automatiquement des notifications à votre point d’accès webhook, ce qui permet à votre connexion de mettre à jour instantanément d’autres outils, d’exécuter des tâches automatisées ou d’afficher les dernières modifications.

Pour obtenir des instructions, consultez la documentation destinée aux développeurs.

Les actions de webhook et les webhooks de connexion ont certains points communs : ils ont tous deux des déclencheurs et peuvent envoyer des événements à des services tiers. Les webhooks de connexion offrent toutefois des fonctionnalités plus étendues :

• Ils peuvent surveiller l’activité dans plusieurs espaces de travail.

• Ils peuvent gérer un nombre illimité d’actions.

En revanche, les actions de webhook sont conçues pour des cas d’utilisation plus simples et sont configurées via des automatisations de base de données avec un ensemble limité de déclencheurs.