Comment obtenir les clés d’intégration et les ID de vos tables sur Notion

Si vous avez décidé de développer une intégration avec Notion, il y a quelques étapes incontournables à suivre avant d’écrire la moindre ligne de code. Le point de départ ? Obtenir votre clé d’intégration et repérer les ID des bases de données sur lesquelles vous allez travailler. Dans cet article, je vous explique comment faire en trois étapes simples, concrètes et sans jargon inutile.

Étape 1 : Créer la clé d’intégration sur Notion

Avant toute chose, il vous faut une clé d’intégration qui servira d’identifiant unique pour interagir avec l’API de Notion. Voici comment procéder :

• Connectez-vous à votre compte via le site officiel de Notion.
• Allez directement à l’adresse suivante : https://www.notion.so/profile/integrations.
• Cliquez sur “Create new integration”.
• Remplissez les informations demandées : nom, description, image (optionnelle).
• N’oubliez pas de sélectionner les bons droits d’accès (lecture, écriture, etc.) selon ce que votre intégration devra faire.
• Une fois validé, copiez le Code secret de votre intégration (c’est votre clé API personnelle).

Cette clé est précieuse : elle authentifie vos requêtes auprès de Notion. Gardez-la bien à l’abri.

Étape 2 : Récupérer les ID des bases de données

Pour travailler avec une base de données Notion via l’API, il vous faut son identifiant unique. Voici comment le trouver :

• Ouvrez votre navigateur et connectez-vous à Notion depuis le site web (évitez l’application de bureau ou mobile).
• Accédez à la page contenant la base de données concernée. Attention, vous devez être sur la page même de la base de données (pas sur une page dans laquelle vous avez une vue de la base de donnée !).
• Regardez l’URL dans la barre d’adresse. Elle ressemblera à ça :

https://www.notion.so/nom-de-votre-espace/ID_de_votre_base_de_données?v=quelquechose

• L’ID de la base de données est la longue chaîne de caractères située après le slash et avant le point d’interrogation.

Par exemple :

https://www.notion.so/monworkspace/1234567890abcdef1234567890abcdef?v=abcd1234

Ici, l’ID est : 1234567890abcdef1234567890abcdef

Gardez cet ID sous la main : il sera indispensable pour vos requêtes.

Étape 3 : Connecter l’intégration à votre page Notion

Même si vous avez votre clé et vos IDs, il vous reste une dernière chose à faire : autoriser explicitement votre intégration à accéder aux pages et bases de données. Voici comment :

• Ouvrez la page ou la base de données concernée sur Notion.
• Cliquez sur les “…” en haut à droite de la page.
• Sélectionnez Connexion.
• Dans la liste, choisissez votre intégration créée à l’étape 1.
• Validez.

Votre intégration est maintenant reliée à votre espace de travail et pourra interagir avec les données selon les autorisations définies.

À retenir

1. Créez votre clé d’intégration via le profil Notion pour authentifier vos appels API.
2. Récupérez les ID des bases de données en inspectant l’URL depuis le site web Notion.
3. Associez votre intégration aux pages concernées en les connectant via l’interface Notion.

Avec ces trois étapes, vous êtes prêt à démarrer le développement de votre intégration Notion en toute sérénité.

---

Si cet article "Comment obtenir les clés d’intégration et les ID de vos tables sur Notion" vous a aidé, si vous avez des questions ou des améliorations à proposer, n'hésitez pas à me laisser un commentaire en bas de page !
Charlie Stram,
Développeur web freelance