Notion API-verbindingen

Bezoek onze developer hub voor documentatie, bronnen en tools voor verbindingsbeheer.

1. Navigeer in je linkerzijbalk naar Instellingen en vervolgens naar het tabblad Verbindingen.

2. Alleen workspace-eigenaren hebben toegang tot het tabblad Verbindingen en kunnen integraties maken. Als je geen beheerder bent, neem dan contact op met je workspace-beheerder of gebruik een andere workspace.

3. Klik onderaan op de link Je eigen verbindingen ontwikkelen.

4. Mijn verbindingen worden geopend in je standaardbrowser. Klik op de knop + Nieuw verbinding.

5. Geef een Naam op voor je verbinding. Optioneel kun je ook een afbeelding uploaden om als Logo te gebruiken.

6. Gebruik het vervolgkeuzemenu om aan te geven met welke Gekoppelde workspace je 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!

   

7. Je interne verbinding is succesvol toegevoegd! Je kunt deze nu zien in je workspace, in het menu Instellingen → Verbindingen.

8. Klik op de ••• naast de interne verbinding om het token voor de interne verbinding op te halen. 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.

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.

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.

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.