> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter Notion à votre application

> Lisez et écrivez des pages et bases de données Notion, ajoutez des commentaires et lancez des flux de travail depuis votre application, avec un compte Notion partagé ou celui de chaque personne.

Connectez votre application à Notion pour lire et écrire des pages et des bases de données, ajouter des commentaires et lancer des flux de travail quand quelque chose change dans votre espace de travail Notion. Utilisez un seul compte partagé pour toute votre application, ou laissez chaque personne connecter son propre compte Notion.

***

## Ce que vous pouvez faire

Intégrez vos pages et bases de données Notion aux flux de travail de votre application.

> [card] Synchroniser des bases de données
>
> Affichez les lignes d'une base de données Notion dans votre application, ou gardez une base de données alignée sur les enregistrements de votre application.

> [card] Écrire des pages
>
> Créez des pages Notion depuis votre application, comme une page pour chaque nouveau client, ou ajoutez des mises à jour à une page existante.

> [card] Travailler avec les commentaires
>
> Lisez les commentaires d'une page et ajoutez-en de nouveaux depuis votre application.

> [card] [Lancer des flux de travail](https://docs.base44.com/fr/Building-your-app/Creating-workflows.md#connector)
>
> Démarrez un flux de travail quand une page ou une base de données est créée, mise à jour, déplacée ou supprimée, ou quand quelqu'un ajoute un commentaire.

**Exemples de prompts**

Dans le chat IA, décrivez la page ou la base de données, ce qui déclenche l'action et les champs dynamiques éventuels. Par exemple :

```text wrap theme={null}
Synchronise une base de données Notion avec les enregistrements de mon CRM.
```

```text wrap theme={null}
Écris les mises à jour de projet de cette application dans une page Notion.
```

```text wrap theme={null}
Affiche dans mon tableau de bord la progression de la checklist Notion d'intégration de l'équipe.
```

```text wrap theme={null}
Crée une nouvelle page Notion pour chaque nouveau client ajouté dans mon application.
```

***

## Connecter Notion

Choisissez comment les personnes se connectent : un compte partagé pour toute votre application, ou le compte de chaque personne.

> [tab] Connecteur partagé
>
> Connectez un compte Notion. Chaque application qui utilise la connexion, et chaque personne qui utilise ces applications, partage ce compte et les pages qu'il peut voir.
>
> **Pour ajouter un connecteur Notion partagé :**
>
> 1. Cliquez sur **Connecteurs** dans la barre latérale de votre espace de travail.
>
> 2. Cliquez sur **Ajouter un connecteur**.
>
> 3. Recherchez **Notion** et cliquez dessus.
>
> 4. Sélectionnez **Connecteur partagé**, puis cliquez sur **Suivant**.
>
> 5. Saisissez un **Nom de la connexion**.
>
> 6. Sous **Qui peut accéder**, choisissez où la connexion peut être utilisée :
>    * **Apps et Super agent :** vos applications et votre Superagent peuvent tous deux l'utiliser. C'est l'option par défaut.
>    * **Apps uniquement :** seules vos applications peuvent l'utiliser.
>    * **Super agent uniquement :** seul votre Superagent peut l'utiliser.
>
> 7. Sous **Autorisations**, choisissez ce que votre application peut faire. **read content** et **read comment** sont déjà sélectionnés. Ajoutez ceux dont votre application a besoin :
>
>    * **insert content :** créer des pages et ajouter des lignes de base de données.
>    * **update content :** modifier des pages et des lignes de base de données existantes.
>    * **insert comment :** ajouter des commentaires.
>
>    ![Configuration d'un connecteur Notion partagé montrant Connection name, Who can access et Permissions avec read content et read comment sélectionnés](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-shared-setup.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=4613834e2b9b1e12620ed0d4c2e5a189)
>
>    Configurer un connecteur Notion partagé
>
> 8. Cliquez sur **Ajouter un connecteur**.
>
> 9. Connectez-vous à Notion et choisissez les pages que votre application peut utiliser. Pour en savoir plus, consultez le guide Notion sur [l'installation d'une connexion](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).

> [tab] Connecteur utilisateur de l'application
>
> Chaque personne connecte son propre compte Notion. Votre application peut ainsi travailler avec les pages qu'elle choisit de partager.
>
> > [!WARNING]
> >
> > Seuls les propriétaires et administrateurs de l'espace de travail peuvent configurer ce connecteur.
>
> > [!TIP]
> >
> > **Avant de configurer ce connecteur :** vous avez besoin d'une intégration Notion publique, avec son Client ID et son Client Secret. Consultez [Utiliser votre propre client OAuth](https://docs.base44.com/fr/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Pour ajouter un connecteur Notion utilisateur de l'application :**
>
> 1. Cliquez sur **Connecteurs** dans la barre latérale de votre espace de travail.
>
> 2. Cliquez sur **Ajouter un connecteur**.
>
> 3. Recherchez **Notion** et cliquez dessus.
>
> 4. Sélectionnez **Connecteur pour les utilisateurs de l'app**, puis cliquez sur **Suivant**.
>
> 5. Copiez l'**URL de callback**.
>
> 6. Ajoutez l'URL de callback comme URI de redirection dans les paramètres de votre intégration Notion.
>
> 7. Remplissez le formulaire **Add Notion Connection** :
>
>    * **Nom du connecteur :** un nom que vous reconnaîtrez plus tard.
>    * **ID client** et **Secret client :** copiez-les depuis les paramètres de votre intégration Notion.
>
>    ![Formulaire Add Notion Connection avec Callback URL, Connector name, Client ID et Client Secret](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-app-user-credentials.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=2d7f3ef817379a121bb34c45ca966c6a)
>
>    Saisir les identifiants de votre intégration Notion
>
> 8. Cliquez sur **Ajouter un connecteur**.
>
> 9. Ouvrez votre application dans l'éditeur d'application.
>
> 10. Demandez au chat IA d'ajouter un moyen pour chaque personne de connecter son propre compte Notion.

***

## Scopes et permissions

Vous contrôlez l'accès Notion de votre application à 2 endroits. Dans Base44, vous choisissez ce que votre application peut faire. Dans Notion, la personne qui se connecte choisit les pages qu'elle peut voir.

> [card]
>
> **1. Vous choisissez dans Base44**
>
> Pour un connecteur partagé, choisissez ce que votre application peut faire sous **Autorisations**. Par défaut, votre application peut lire les pages, les bases de données et les commentaires. Ajoutez les autorisations d'écriture quand elle doit aussi créer ou modifier des pages, des lignes ou des commentaires.
>
> Pour un connecteur utilisateur de l'application, ce que votre application peut faire dépend des capacités définies sur votre intégration Notion.
>
> **2. Vous choisissez dans Notion**
>
> La personne qui se connecte à Notion choisit les pages que votre application peut utiliser. C'est vous pour un connecteur partagé, et chaque personne pour un connecteur utilisateur de l'application. Pour en savoir plus, consultez le guide Notion sur [l'installation d'une connexion](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).
>
> **Accès :** votre application travaille avec les pages et bases de données partagées lors de la connexion, dans l'espace de travail Notion auquel la personne s'est connectée. Chaque connexion affiche le nom de son espace de travail Notion, pour que vous puissiez distinguer les connexions.

***

## Utiliser les fonctions backend

Une fois Notion connecté, vos fonctions backend peuvent récupérer un jeton d'accès et appeler directement l'API Notion. Base44 gère la connexion pour vous.

* Pour une connexion partagée, utilisez `getConnection()` pour récupérer le jeton.
* Pour une connexion utilisateur de l'application, utilisez `getCurrentAppUserConnection()` pour que chaque requête utilise le jeton de la personne connectée.

Appelez l'API Notion sur `api.notion.com`. Transmettez le jeton dans l'en-tête `Authorization` et la version de l'API dans l'en-tête `Notion-Version` :

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("notion");

const response = await fetch("https://api.notion.com/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Notion-Version": "2025-09-03",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "Clients" }),
});
const { results } = await response.json();
```

> [card] [Connecteurs partagés](https://docs.base44.com/fr/developers/backend/resources/connectors/shared-connectors.md)
>
> Configurez, déployez et appelez une connexion partagée depuis une fonction backend.

> [card] [Connecteurs utilisateur de l'application](https://docs.base44.com/fr/developers/backend/resources/connectors/app-user-connectors.md)
>
> Récupérez un jeton par utilisateur et appelez l'API au nom de la personne connectée.

***

## Dépannage

Vérifiez la connexion et les pages qu'elle peut voir si Notion cesse de fonctionner dans votre application.

> [accordion] La connexion doit être reconnectée
>
> Si votre application perd l'accès à Notion ou si sa connexion expire, la connexion affiche une section **Reconnecter cette connexion**.
>
> * **Connecteur partagé :** [reconnectez-le](https://docs.base44.com/fr/Integrations/Connectors.md#managing-your-connectors) et connectez-vous avec le même compte Notion. Toutes les applications qui l'utilisent fonctionnent à nouveau.
> * **Connecteur utilisateur de l'application :** chaque personne reconnecte son propre compte Notion depuis votre application.

> [accordion] Votre application ne trouve pas une page ou une base de données
>
> Votre application ne voit que les pages partagées avec la connexion. Reconnectez-la et choisissez la page dans Notion, ou [ajoutez la connexion à la page](https://www.notion.com/help/add-and-manage-connections-with-the-api#add-connections-to-pages) dans Notion.

> [accordion] Un flux de travail s'exécute trop souvent
>
> Notion envoie un événement chaque fois que le contenu d'une page change. Un espace de travail très actif peut donc démarrer un flux de travail de nombreuses fois. Demandez au chat IA d'ajouter une condition pour que le flux de travail ne s'exécute que pour une seule page ou base de données.

> [!NOTE]
>
> Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](https://docs.base44.com/index.md).


## Related topics

- [Connecter Slack à votre application](https://docs.base44.com/fr/Integrations/slack-connectors.md)
- [Connecter Wix à votre application](https://docs.base44.com/fr/Integrations/wix-connector.md)
- [Connecter Outlook à votre application](https://docs.base44.com/fr/Integrations/outlook-connector.md)
- [Connecter Databricks à votre application](https://docs.base44.com/fr/Integrations/databricks-connector.md)
- [Connecter Snowflake à votre application](https://docs.base44.com/fr/Integrations/snowflake-connector.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.