> ## 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.

# Notion mit deiner App verbinden

> Lies und schreibe Notion-Seiten und -Datenbanken, füge Kommentare hinzu und führe Workflows aus deiner App aus, mit einem gemeinsamen Notion-Konto oder dem eigenen Notion-Konto jeder Person.

Verbinde deine App mit Notion, um Seiten und Datenbanken zu lesen und zu schreiben, Kommentare hinzuzufügen und Workflows auszuführen, wenn sich in deinem Notion-Workspace etwas ändert. Nutze ein gemeinsames Konto für deine ganze App oder lass jede Person ihr eigenes Notion-Konto verbinden.

***

## Was du tun kannst

Bring deine Notion-Seiten und -Datenbanken in die Workflows deiner App.

> [card] Datenbanken synchronisieren
>
> Zeige Zeilen aus einer Notion-Datenbank in deiner App an oder halte eine Datenbank mit den Datensätzen deiner App synchron.

> [card] Seiten schreiben
>
> Erstelle Notion-Seiten aus deiner App, etwa eine Seite für jeden neuen Kunden. Oder füge einer bestehenden Seite Updates hinzu.

> [card] Mit Kommentaren arbeiten
>
> Lies die Kommentare auf einer Seite und füge aus deiner App neue hinzu.

> [card] [Workflows ausführen](https://docs.base44.com/de/Building-your-app/Creating-workflows.md#connector)
>
> Starte einen Workflow, wenn eine Seite oder Datenbank erstellt, aktualisiert, verschoben oder gelöscht wird oder wenn jemand kommentiert.

**Beispiel-Prompts**

Beschreibe im KI-Chat die Seite oder Datenbank, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Synchronisiere eine Notion-Datenbank mit meinen CRM-Datensätzen.
```

```text wrap theme={null}
Schreibe Projekt-Updates aus dieser App in eine Notion-Seite.
```

```text wrap theme={null}
Zeige in meinem Dashboard den Fortschritt der Notion-Checkliste für das Team-Onboarding an.
```

```text wrap theme={null}
Erstelle neue Notion-Seiten für jeden neuen Kunden, der in meiner App hinzugefügt wird.
```

***

## Notion verbinden

Wähle, wie sich Personen verbinden: mit einem gemeinsamen Konto für deine ganze App oder jeweils mit ihrem eigenen Konto.

> [tab] Gemeinsamer Connector
>
> Verbinde ein Notion-Konto. Jede App, die die Verbindung nutzt, und alle, die diese Apps nutzen, teilen sie und die Seiten, die sie sehen kann.
>
> **So fügst du einen gemeinsamen Notion-Connector hinzu:**
>
> 1. Klicke in der Seitenleiste deines Workspaces auf **Konnektoren**.
>
> 2. Klicke auf **Connector hinzufügen**.
>
> 3. Suche nach **Notion** und klicke darauf.
>
> 4. Wähle **Gemeinsamer Connector** aus und klicke dann auf **Weiter**.
>
> 5. Gib einen **Verbindungsname** ein.
>
> 6. Wähle unter **Wer hat Zugriff** aus, wo die Verbindung genutzt werden kann:
>    * **Apps und Super-Agent:** Deine Apps und dein Superagent können sie beide nutzen. Das ist der Standard.
>    * **Nur Apps:** Nur deine Apps können sie nutzen.
>    * **Nur Super-Agent:** Nur dein Superagent kann sie nutzen.
>
> 7. Wähle unter **Berechtigungen** aus, was deine App tun kann. **read content** und **read comment** sind bereits ausgewählt. Füge hinzu, was deine App davon braucht:
>
>    * **insert content:** Seiten erstellen und Datenbankzeilen hinzufügen.
>    * **update content:** Bestehende Seiten und Datenbankzeilen ändern.
>    * **insert comment:** Kommentare hinzufügen.
>
>    ![Einrichtung eines gemeinsamen Notion-Connectors mit Connection name, Who can access und Permissions, mit ausgewähltem read content und read comment](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-shared-setup.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=4613834e2b9b1e12620ed0d4c2e5a189)
>
>    Einen gemeinsamen Notion-Connector einrichten
>
> 8. Klicke auf **Connector hinzufügen**.
>
> 9. Melde dich bei Notion an und wähle die Seiten aus, die deine App nutzen kann. Mehr dazu in Notions Anleitung zum [Installieren einer Verbindung](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).

> [tab] App-Nutzer-Connector
>
> Jede Person verbindet ihr eigenes Notion-Konto. So kann deine App mit den Seiten arbeiten, die sie teilt.
>
> > [!WARNING]
> >
> > Nur Workspace-Owner und -Admins können das einrichten.
>
> > [!TIP]
> >
> > **Bevor du das einrichtest:** Du brauchst eine öffentliche Notion-Integration mit ihrer Client-ID und ihrem Client-Secret. Siehe [Deinen eigenen OAuth-Client verwenden](https://docs.base44.com/de/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **So fügst du einen App-Nutzer-Connector für Notion hinzu:**
>
> 1. Klicke in der Seitenleiste deines Workspaces auf **Konnektoren**.
>
> 2. Klicke auf **Connector hinzufügen**.
>
> 3. Suche nach **Notion** und klicke darauf.
>
> 4. Wähle **App-Benutzer-Connector** aus und klicke dann auf **Weiter**.
>
> 5. Kopiere die **Callback-URL**.
>
> 6. Füge die Callback-URL in den Einstellungen deiner Notion-Integration als Redirect-URI hinzu.
>
> 7. Fülle das Formular **Add Notion Connection** aus:
>
>    * **Connector name:** Ein Name, den du später wiedererkennst.
>    * **Client-ID** und **Client-Geheimnis:** Kopiere sie aus den Einstellungen deiner Notion-Integration.
>
>    ![Das Formular Add Notion Connection mit Callback URL, Connector name, Client ID und 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)
>
>    Die Zugangsdaten deiner Notion-Integration eingeben
>
> 8. Klicke auf **Konnektor hinzufügen**.
>
> 9. Öffne deine App im App-Editor.
>
> 10. Bitte den KI-Chat, eine Möglichkeit hinzuzufügen, mit der Personen ihr eigenes Notion-Konto verbinden können.

***

## Scopes und Berechtigungen

Du steuerst den Notion-Zugriff deiner App an 2 Stellen. In Base44 wählst du, was deine App tun kann. In Notion wählt die Person, die sich anmeldet, welche Seiten die App sehen kann.

> [card]
>
> **1. Du wählst in Base44**
>
> Bei einem gemeinsamen Connector wählst du unter **Berechtigungen** aus, was deine App tun kann. Deine App kann standardmäßig Seiten, Datenbanken und Kommentare lesen. Füge die Schreibberechtigungen hinzu, wenn sie auch Seiten, Zeilen oder Kommentare erstellen oder ändern muss.
>
> Bei einem App-Nutzer-Connector ergibt sich, was deine App tun kann, aus den Fähigkeiten, die in deiner Notion-Integration festgelegt sind.
>
> **2. Du wählst in Notion**
>
> Wer sich bei Notion anmeldet, wählt die Seiten aus, die deine App nutzen kann. Bei einem gemeinsamen Connector bist das du, bei einem App-Nutzer-Connector jede Person selbst. Mehr dazu in Notions Anleitung zum [Installieren einer Verbindung](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).
>
> **Zugriff:** Deine App arbeitet mit den Seiten und Datenbanken, die bei der Anmeldung geteilt wurden, im Notion-Workspace, bei dem sich die Person angemeldet hat. Jede Verbindung zeigt den Namen ihres Notion-Workspace. So kannst du Verbindungen auseinanderhalten.

***

## Backend-Funktionen nutzen

Sobald Notion verbunden ist, können deine Backend-Funktionen ein Zugriffstoken abrufen und die Notion API direkt aufrufen. Base44 übernimmt die Anmeldung für dich.

* Für eine gemeinsame Verbindung nutze `getConnection()`, um das Token abzurufen.
* Für eine App-Nutzer-Verbindung nutze `getCurrentAppUserConnection()`, damit jede Anfrage das Token der angemeldeten Person verwendet.

Rufe die Notion API unter `api.notion.com` auf. Übergib das Token im Header `Authorization` und die API-Version im Header `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] [Gemeinsame Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/shared-connectors.md)
>
> Konfiguriere, deploye und rufe eine gemeinsame Verbindung aus einer Backend-Funktion auf.

> [card] [App-Nutzer-Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/app-user-connectors.md)
>
> Rufe ein Token pro Nutzer ab und rufe die API im Namen der angemeldeten Person auf.

***

## Fehlerbehebung

Prüfe die Verbindung und die Seiten, die sie sehen kann, wenn Notion in deiner App nicht mehr funktioniert.

> [accordion] Die Verbindung muss neu verbunden werden
>
> Wenn deine App den Zugriff auf Notion verliert oder ihre Anmeldung abläuft, zeigt die Verbindung einen Bereich **Diese Verbindung erneut verbinden**.
>
> * **Gemeinsamer Connector:** [Verbinde ihn neu](https://docs.base44.com/de/Integrations/Connectors.md#managing-your-connectors) und melde dich mit demselben Notion-Konto an. Jede App, die ihn nutzt, funktioniert dann wieder.
> * **App-Nutzer-Connector:** Jede Person verbindet ihr eigenes Notion-Konto in deiner App neu.

> [accordion] Deine App findet eine Seite oder Datenbank nicht
>
> Deine App sieht nur die Seiten, die mit der Verbindung geteilt wurden. Verbinde sie neu und wähle die Seite in Notion aus. Oder [füge die Verbindung der Seite hinzu](https://www.notion.com/help/add-and-manage-connections-with-the-api#add-connections-to-pages), direkt in Notion.

> [accordion] Ein Workflow läuft zu oft
>
> Notion sendet bei jeder Änderung am Inhalt einer Seite ein Ereignis. In einem aktiven Workspace kann ein Workflow daher viele Male starten. Bitte den KI-Chat, eine Bedingung hinzuzufügen, damit der Workflow nur für eine Seite oder Datenbank läuft.

> [!NOTE]
>
> Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der [englischen Version](https://docs.base44.com/index.md).


## Related topics

- [Snowflake mit deiner App verbinden](https://docs.base44.com/de/Integrations/snowflake-connector.md)
- [Databricks mit deiner App verbinden](https://docs.base44.com/de/Integrations/databricks-connector.md)
- [Slack mit deiner App verbinden](https://docs.base44.com/de/Integrations/slack-connectors.md)
- [Wix mit deiner App verbinden](https://docs.base44.com/de/Integrations/wix-connector.md)
- [Outlook mit deiner App verbinden](https://docs.base44.com/de/Integrations/outlook-connector.md)


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