Home / Companies / Webflow / Blog / Post Details
Content Deep Dive

Sync Notion databases with Webflow CMS to build dynamic knowledge bases

Blog post from Webflow

Post Details
Company
Date Published
Author
Webflow Team
Word Count
624
Language
English
Hacker News Points
-
Summary

The integration of Notion and Webflow aims to combine Notion's collaborative editing capabilities with Webflow's robust CMS infrastructure for publishing websites, despite challenges posed by their differing data structures and rate limits. Notion's nested content and metadata-only webhooks do not naturally align with Webflow's flat-field system, necessitating a hybrid architecture that combines webhooks and polling to manage updates. The constraints include Notion's limit of three requests per second and Webflow's 60-120 requests per minute, with additional bottlenecks from Webflow's publish endpoint allowing only one request per minute. The integration process involves configuring OAuth 2.0 authentication, setting up webhook endpoints with HMAC validation, and designing data transformation layers to convert Notion's nested JSON blocks into Webflow's HTML format. The task requires addressing differences in property types and maintaining rich text formatting while handling platform-specific schema variations. The sync orchestration relies on combining instant webhook updates with periodic full syncs to ensure data consistency and manage potential discrepancies.