- Pages en blocks: Maak pages aan of update ze, haal content op als markdown, manipuleer block-children en verplaats pages tussen parents.
- Databases en data sources: Maak databases aan, query een data source met filters en sorting en beheer templates en properties.
- Search: Doorzoek alle toegankelijke pages en databases op titel via één endpoint.
- Comments en views: Plaats threaded comments, update of verwijder ze en beheer saved views met eigen queries.
- File uploads en OAuth: Upload bestanden (inclusief multi-part), lijst uploads en beheer OAuth-tokens (exchange, revoke, introspect).
Menu
Notion
Notion is een all-in-one workspace waarin teams notities, databases, projecten en wiki's combineren. Via de REST API maak je pages aan, manipuleer je blocks, query je databases en data sources, zoek je in titels, beheer je comments, uploads en views en verifieer je gebruikers. Authenticatie gebeurt via OAuth 2.0 of een integration-token, de versie wordt meegegeven via de Notion-Version-header. Notion publiceert een publieke OpenAPI 3.1-spec en een officiële JavaScript-SDK.
Samenvatting van de Notion API
Met de Notion API bouw je integraties die informatie uit je eigen stack automatisch in de Notion-workspace plaatsen of eruit ophalen. Pages en blocks zijn atomair aanspreekbaar, databases werken via een nieuwe data-sources-laag en comments of views maken samenwerking mogelijk.
API Quick Facts REST
- Authenticatie OAuth2, Bearer Token
- Methods GET (19)PATCH (8)DELETE (4)POST (15)
- Rate limits Gemiddeld 3 requests per seconde (burst-limiet), per integratie
- Webhooks Beschikbaar
- Sandbox Niet beschikbaar
- Response format JSON
- Versionering Header-based
- SDK's Node.js
Laatste ontwikkelingen bij de Notion API
Notion publiceerde in mei 2021 een publieke REST API met endpoints voor pages, blocks en gebruikers. In 2022 volgde database-querying met een aparte query-endpoint en richer filters. Sinds 2024 is de API uitgebreid met data sources (die databases abstraheren), markdown-in/-out voor pages, file-uploads met multi-part, een views-API voor saved views en een custom_emojis-endpoint. In 2025 werden webhooks en OAuth-introspection toegevoegd. Versioning loopt via de Notion-Version-header met date-gebaseerde versies (huidig 2022-06-28). De v1-API en OpenAPI 3.1-spec worden onderhouden op developers.notion.com.
API versies
Views API Major release
1 juni 2025 Views-endpoints toegevoegd voor het beheren van saved views, view-queries en resultaten.
File uploads Major release
1 november 2024 POST /file_uploads endpoints toegevoegd voor single en multi-part file uploads inclusief complete-flow.
Markdown IO
1 september 2024 GET en PATCH /pages/{id}/markdown toegevoegd voor import/export van page-content als markdown.
Data sources Major release
1 maart 2024 Data sources-laag geïntroduceerd boven databases met aparte query-, create- en template-endpoints.
Database queries Major release
1 maart 2022 POST /databases/{id}/query toegevoegd met filters en sorts; Notion-Version-header geïntroduceerd.
Publieke v1 API Major release
1 mei 2021 Eerste publieke REST API gelanceerd met pages, blocks en users-endpoints.
Documentatie & resources
Integraties
Populaire koppelingen met Notion
Drie categorieën software waarmee Notion vaak gekoppeld wordt.
Kies voor een kopzorg minder
Stop met handwerk en laat professionals het goed automatiseren!
Een koppeling laten bouwen is binnen handbereik, op maat en precies zoals je wilt