Notion-API-Verbindungen

In unserem Developer Hub findest du Dokumentation, Ressourcen und Tools für die Verbindungsverwaltung.

1. Gehe in der linken Seitenleiste auf Einstellungen und dann auf den Tab Verbindungen.

2. Nur Workspace-Besitzer/-innen können auf den Tab Verbindungen zugreifen und Integrationen erstellen. Wenn du kein Admin bist, wende dich bitte an deinen Workspace-Admin oder verwende einen anderen Workspace.

3. Klicke unten auf den Link Eigene Verbindungen entwickeln.

4. Meine Verbindungen werden in deinem Standardbrowser geöffnet. Klicke auf den Button + Neue Verbindung .

5. Gib einen Namen für deine Verbindung an. Du kannst auch ein Bild als Logo hochladen.

6. Lege über das Dropdown-Menü fest, in welchem verknüpften Workspace du die Verbindung verwenden möchtest.

   

   Hinweis: Vergewissere dich, dass du in deiner Web-Session bei Notion mit demselben Konto angemeldet bist wie auf dem Desktop. Ansonsten werden falsche Konten und Workspaces angezeigt.

   

7. Deine interne Verbindung wurde erfolgreich hinzugefügt! Du findest sie nun in im Menü Einstellungen → Verbindungen.

8. Klicke neben der internen Verbindung auf •••, um den internen Verbindungstoken abzurufen. Den Token brauchst du für API-basierte Automatisierungen, für Workflows deines Teams und um deinen Workspace mit bestimmten Partnerplattformen zu verknüpfen.

Alle neu hinzugefügten Verbindungen sind zunächst intern. Wenn du als Entwickler/-in an einer öffentlichen Verbindung arbeitest, solltest du zunächst eine interne Verbindung nach den oben angegebenen Anweisungen erstellen.

Dann kannst du diese mithilfe unseres Developer Guides in eine öffentliche Verbindung umwandeln.

Bei der Anwendungseinrichtung können die für die Benutzer/-innen erforderlichen Zugriffsberechtigungen von den Entwickler/-innen festgelegt werden.

• Inhaltliche Berechtigungen:

  • Lesezugriff

  • Schreibzugriff

  • Inhalte hinzufügen

• Nutzungsberechtigungen:

  • Keine Benutzerdaten

  • Benutzerdaten-Lesezugriff (gilt nicht für E-Mail-Adressen)

  • Benutzerdaten-Lesezugriff (gilt auch für E-Mail-Adressen)

Installiert ein/-e Nutzer/-in eine Verbindung, wird diese Zugriffsebene angezeigt. Du findest sie auch im Freigabemenü aller Seiten, denen die Verbindung hinzugefügt wurde. Erfahre mehr über das Installieren von Verbindungen in einem Workspace →

Integrations-Webhooks ermöglichen es Verbindungen, Änderungen in Notion-Workspaces in Echtzeit zu überwachen und darauf zu reagieren.

Wenn Änderungen an Seiten oder Datenbanken vorgenommen werden, die mit deiner Verbindung geteilt werden, sendet Notion automatisch Benachrichtigungen an deinen Webhook-Endpunkt, sodass deine Verbindung andere Tools sofort aktualisieren, automatisierte Aufgaben ausführen oder die neuesten Änderungen anzeigen kann.

Eine Anleitung findest du in unseren Dokumenten für Entwickler/-innen.

Webhook-Aktionen und Integrations-Webhooks haben einige Ähnlichkeiten – beide haben Auslöser und können Ereignisse an Drittanbieterdienste senden. Integrations-Webhooks bieten jedoch umfassendere Funktionen:

• Sie können Aktivitäten über mehrere Workspaces hinweg überwachen.

• Sie können eine unbegrenzte Anzahl von Aktionen ausführen.

Im Gegensatz dazu sind Webhook-Aktionen für einfachere Anwendungsfälle konzipiert und werden durch Datenbankautomatisierungen mit einer begrenzten Anzahl von Auslösern konfiguriert.