.png)
Webflow Integration Guide
Integrate Webflow sites, CMS content, forms, assets, and selected events with enterprise systems through REST APIs, OAuth 2.0, API tokens, and webhooks.
Webflow integration options at a glance
Webflow’s primary integration model is the Data API v2 REST API, authenticated with OAuth 2.0 or bearer API tokens. The API supports sites, CMS Collections and Collection items, pages, assets, forms, submissions, webhooks, and other documented resources. Webflow also provides webhook notifications for selected event types, bulk operations for some CMS workflows, and asset endpoints for supported file operations. Martini can consume these APIs, receive Webflow webhook events through an exposed API, schedule paginated synchronization workflows, map JSON payloads, apply validation and business rules, and route results to enterprise applications. Event coverage should be supplemented with scheduled REST reads where Webflow does not provide the required notification.
Common Webflow integration patterns
Common Webflow data objects used in integrations
Authentication and security considerations
Authentication choices
Webflow supports OAuth 2.0 for applications accessing multiple users, sites, or workspaces, and bearer API tokens for controlled internal integrations. Select the approach based on the ownership and distribution model of the integration.
Credential protection
- Store Webflow tokens and OAuth configuration in Martini secrets or environment configuration.
- Grant only the scopes required for sites, Collections, pages, assets, forms, ecommerce resources, or webhooks.
- Confirm whether each endpoint requires site-level, workspace-level, or resource-specific authorization.
Inbound webhook security
Protect Martini endpoints receiving Webflow events with authentication, request validation, event deduplication, and controlled logging. Avoid exposing personal form data unnecessarily in workflow logs.
Operational considerations for Webflow integrations
Rate limits and pagination
Confirm current Webflow limits for the account, endpoint, API version, and authentication method. Process list responses page by page, preserve cursor state, control concurrency, and use exponential backoff for transient 429 responses.
Webhook coverage and synchronization
Webflow webhook support is limited to documented event types. Combine event-driven workflows with scheduled REST reads for unsupported changes, and retrieve the current resource when a notification does not contain complete data.
Idempotency and retries
Webhook deliveries may be retried or duplicated. Store a stable event identifier where available, or combine event type, resource identifier, and timestamp. Use upsert behavior and checkpointing to prevent repeated downstream effects.
Schema and publishing controls
Validate Collection field identifiers, types, references, and required fields before writing. Keep draft, approval, and publishing actions explicit, and test mappings after Webflow API or Collection schema changes.
Assets and personal data
Decide whether an integration transfers an asset file, URL, or metadata. Handle file constraints separately from JSON errors, verify URL access requirements, and limit exposure of form submission data in logs.
Why use Martini instead of scripts or point-to-point integrations?
Reusable orchestration
Martini separates Webflow API calls, webhook intake, mappings, business rules, target writes, and error handling into maintainable workflows and reusable integration assets.
Event and batch flexibility
Webflow events can trigger real-time processing, while scheduled Martini workflows can handle pagination, reconciliation, and resources without sufficient webhook coverage. Supported CMS bulk operations can be combined with controlled retries and checkpointing.
Reliable enterprise processing
Instead of maintaining isolated scripts, teams can centralize secrets, validation, transformation, idempotency, retry behavior, monitoring, and downstream API orchestration in Martini.
API-led integration
Martini can consume Webflow REST APIs and expose controlled APIs for other applications, allowing Webflow to participate in broader enterprise workflows without requiring a dedicated vendor connector.