Notion API-verbindingen
Met de API van Notion kun je aangepaste interne verbindingen maken. Sommige van onze partners hebben ook een API-token nodig om hun platform aan je Notion-workspace te koppelen. Hieronder lees je hoe je dit instelt.
Je kunt persoonlijke toegangstokens beheren vanuit Notion. Schakel de ontwikkelaarsmodus in via Instellingen en open vervolgens persoonlijke toegangstokens vanuit het gedeelte voor ontwikkelaars in je zijbalk. Bezoek onze developer hub voor documentatie, bronnen en tools voor het beheer van koppelingen.
Opmerking: Elke koppeling heeft een of meer eigenaren en elke eigenaar kan de koppeling beheren en het API-token ervan ophalen. Wie een koppeling kan maken, hangt af van je abonnement en de instellingen van je workspace. Lees meer over instellingen voor Enterprise-koppelingen →
Op zoek naar beheerdertokens? De tokens op Deze pagina werken binnen één workspace en beheren de page content. Als je de uitvoering van organisatiebeheerderstaken nodig hebt, zoals Exporteren, juridische reserveringen of het uitloggen van gebruikers, raadpleeg dan Admin API's voor Enterprise-organisaties.
Welk token heb ik nodig? Notion gebruikt een paar verschillende tokens. Het token dat je kopieert voor een interne verbinding is het API-token, en dat is wat in dit artikel wordt behandeld. Persoonlijke toegangstokens zijn gekoppeld aan je eigen account. OAuth regelt apps waarbij je je aanmeldt. Als een partnerplatform om een token vraagt voor een verbinding die je hebt gemaakt, gebruik je het API-token.
Navigeer in je linkerzijbalk naar
Instellingenen vervolgens naar het tabbladVerbindingen.Wie verbindingen kan maken, hangt af van je workspace. Met een gratis of Plus-abonnement kunnen alleen workspace-eigenaren verbindingen maken. Met een Business- of Enterprise-abonnement kunnen workspace-eigenaren ook leden of leden van bepaalde groepen toestemming geven om verbindingen te maken. Kun je geen verbinding maken? Vraag dan een workspace-eigenaar om hulp.
Schakel Ontwikkelaarsmodus in en open vervolgens persoonlijke toegangstokens vanuit het gedeelte voor ontwikkelaars in je zijbalk.
Klik op
+ Nieuw koppeling.Geef een
Naamop voor je verbinding. Optioneel kun je ook een afbeelding uploaden om alsLogote gebruiken.Gebruik het vervolgkeuzemenu om aan te geven met welke
Gekoppelde workspaceje deze verbinding wilt gebruiken.
Opmerking: Zorg ervoor dat je in je websessie bent ingelogd op Notion met hetzelfde account als dat je op desktop hebt gebruikt. Anders zie je niet het juiste account en de juiste workspaces!

Je interne verbinding is succesvol toegevoegd! Je kunt deze nu zien in je workspace, in het menu
Instellingen→Verbindingen.Klik op
•••naast de interne verbinding om het API-token te kopiëren. Je hebt dit token nodig voor alle op API gebaseerde automatiseringen of workflows die je team maakt, of om je workspace te koppelen aan bepaalde partnerplatforms.

Opmerking: Interne verbindingen zijn workspace-specifiek, dus om de gekoppelde workspace te wijzigen, moet je een nieuwe verbinding maken.

Elke interne verbinding heeft minstens één eigenaar. Eigenaren kunnen de instellingen van de verbinding wijzigen en het API-token ophalen. Je kunt het eigenaarschap delen, zodat meer dan één persoon dezelfde verbinding kan beheren. Zo loopt het werk door als iemand een andere rol krijgt of vertrekt.
Een eigenaar toevoegen of verwijderen:
Open de Developer Portal en selecteer je verbinding.
Open het tabblad
Verbindingseigenaren.Voeg een lid of groep toe als eigenaar of verwijder een eigenaar.
Let op het volgende met betrekking tot verbindingseigenaren:
Alleen volledige leden en workspace-eigenaren kunnen eigenaar zijn. Gasten en leden met beperkte toegang kunnen dit niet.
Wie je als eigenaar kunt toevoegen, hangt ook af van de instelling van je workspace voor wie verbindingen mag maken.
Een verbinding behoudt altijd ten minste één eigenaar, dus je kunt de laatste niet verwijderen.
Als je een workspace-eigenaar bent en een verbinding moet overnemen, voeg jezelf dan eerst toe als eigenaar.
Als de laatste eigenaar de workspace verlaat, stopt het API-token van de verbinding onmiddellijk met werken.
Je kunt eigenaarschap delen bij Plus-, Business- en Enterprise-abonnementen via Notion in je browser of de desktop-app.
Alle nieuw toegevoegde verbindingen zijn in eerste instantie intern. Als je een ontwikkelaar bent die aan een openbare verbinding werkt, gebruik dan eerst de bovenstaande instructies om een interne verbinding te maken.
Volg daarna de instructies in onze ontwikkelaarshandleiding om deze om te zetten naar een openbare verbinding.
Als je een openbare koppeling aanmaakt, kies je wie deze kan installeren:
Elke workspace: iedereen kan je koppeling in een eigen Notion-workspace installeren.Geselecteerde workspaces: alleen in de workspaces die je opgeeft, kan je koppeling worden geïnstalleerd.
Kies Geselecteerde workspaces als je iets bouwt voor je eigen bedrijf en niet wilt dat andere organisaties het kunnen installeren.
Notion controleert dit telkens wanneer iemand je koppeling installeert. Als de workspace van die persoon niet op je lijst staat, stopt de installatie en krijgt diegene een foutmelding.
Alleen koppelingen die iedereen kan installeren, kunnen in de galerij met koppelingen worden vermeld. Een koppeling die beperkt is tot geselecteerde workspaces verschijnt daar niet.
Opmerking: Je kiest dit wanneer je de koppeling aanmaakt. Heb je later een andere instelling nodig, dan maak je een nieuwe koppeling aan.
Een koppeling waarvan je de eigenaar bent, verschijnt in het ontwikkelaarsportaal voor elke workspace waarin de koppeling mag worden geïnstalleerd, al is geïnstalleerd of waarin je deze hebt gebouwd.
Elke openbare koppeling heeft één workspace waarin je deze bouwt en test. Je kunt overstappen naar een andere workspace zonder opnieuw te beginnen.
Open je koppeling in het ontwikkelaarsportaal.
Ga naar de instellingen van de koppeling.
Kies de workspace waarin je wilt bouwen.
Notion koppelt je koppeling aan de workspace die je hebt gekozen. Je hoeft geen nieuwe koppeling aan te maken.
Tijdens het instellen van de app kunnen ontwikkelaars het vereiste toegangsniveau van de gebruiker kiezen.
Mogelijkheden voor inhoud:
Alleen content lezen
Alleen content schrijven
Content invoegen
Mogelijkheden voor gebruiker
Geen gebruikersinformatie
Gebruikersinfo lezen (exclusief het e-mailadres van de gebruiker)
Gebruikersinfo lezen (inclusief het e-mailadres van de gebruiker)
Wanneer gebruikers verbindingen installeren, wordt dit toegangsniveau weergegeven. Het wordt ook getoond in het Delen-menu van alle pagina's waaraan de verbinding is toegevoegd. Meer informatie over het installeren van verbindingen in een workspace →
Met koppelingswebhooks kunnen verbindingen wijzigingen in Notion workspaces in realtime monitoren en hierop reageren.
Wanneer er wijzigingen plaatsvinden in pagina's of databases die met je verbinding zijn gedeeld, stuurt Notion automatisch meldingen naar je webhook-eindpunt, waardoor je verbinding direct andere tools kan bijwerken, geautomatiseerde taken kan uitvoeren of de laatste wijzigingen kan weergeven.
Bezoek voor instructies onze instructies.
Koppelingswebhooks ondersteunen momenteel geen meldingen voor:
Gebruikerswijzigingen (inclusief wijzigingen in workspace-lidmaatschap, e-mail-/naam-Updates en wijzigingen in machtigingen).
Wijzigingen in instellingen voor workspace en Teamspace.
Gebruik voor dit soort meldingen in plaats daarvan het auditlogboek.
Webhook-acties en koppelingswebhooks vertonen enige gelijkenissen—beide hebben triggers en kunnen gebeurtenissen naar externe services sturen. Koppelingswebhooks bieden echter bredere mogelijkheden:
Ze kunnen activiteit in meerdere workspaces monitoren.
Ze kunnen een onbeperkt aantal Acties afhandelen.
Webhook-acties zijn daarentegen ontworpen voor eenvoudigere use-cases en worden geconfigureerd via database-automatisering met een beperkt aantal triggers.
