KwikScaleAI

Publishing

Webflow

Available

Publish directly into a Webflow CMS Collection via OAuth. Map KwikScaleAI's article fields to your collection's custom fields, then let content go live — or stage as draft for manual review.

Prerequisites

  • A Webflow site on a CMS plan or higher (CMS API is gated by site plan, not workspace plan).
  • A CMS Collection prepared for blog articles. At minimum you need a plain text field for title, a rich text field for body, and the built-in Name + Slug fields.
  • Workspace member role with Design permission or higher.

Setup guide

  1. In KwikScaleAI: Integrations → Webflow → Connect.
  2. You'll be redirected to Webflow's OAuth consent page. Select the site you want to connect, grant CMS access, and confirm.
  3. Back in KwikScaleAI, pick the Collection from the dropdown.
  4. Map your collection fields:
    • title→ your collection's title/name field slug (required)
    • body → your rich text body field slug (required)
    • slug→ the collection's slug field (optional; defaults to auto-generated)
    • summary → meta description or excerpt field (optional)
    • featuredImage → image field (optional)
    • publishDate → date field (optional)
  5. Choose publish mode: live or draft.
  6. Click Test connection.

How it works

On publish, KwikScaleAI builds a fieldDataobject for Webflow's CMS API by applying your field mapping to the canonical article. The call is a POST /collections/{collectionId}/items/live (live mode) or /items (draft mode). Update is a PATCH /collections/{collectionId}/items/{itemId}/live.

Example fieldData (depends on your mapping)
{
  "isArchived": false,
  "isDraft": false,
  "fieldData": {
    "name": "How We Doubled Organic Traffic",
    "slug": "how-we-doubled-organic-traffic",
    "post-body": "<h1>...</h1><p>...</p>",
    "meta-description": "The exact playbook we used to 2x traffic...",
    "featured-image": {
      "url": "https://cdn.example.com/hero.jpg",
      "alt": "Traffic chart"
    },
    "publish-date": "2026-04-16T12:00:00.000Z"
  }
}

Configuration

accessTokenRequired

string (OAuth token)

OAuth access token, filled automatically after you complete the consent flow. You don't paste this manually.

webflowSiteIdRequired

string

Webflow site ID. Populated automatically from OAuth — you select your site during the flow.

collectionIdRequired

string

CMS collection where articles are written. Picked from a dropdown of the site's collections in the dashboard.

fieldMapping.titleRequired

string

Field slug in your collection that receives the article title (e.g. 'name', 'post-title'). Required.

fieldMapping.bodyRequired

string

Field slug for the rich-text article body (e.g. 'post-body', 'content').

fieldMapping.slugOptional

string

Slug field. Most collections have a built-in 'slug' field; if so, use it.

fieldMapping.summaryOptional

string

Short summary / meta description field slug.

fieldMapping.featuredImageOptional

string

Image field slug for the hero/featured image.

fieldMapping.publishDateOptional

string

Date field slug for publishedAt timestamp.

publishModeOptional

'draft' | 'live'

live publishes immediately via Webflow's /items/live endpoint. draft creates the item in Webflow CMS but requires a manual Publish Site to go public.

Default: live

Capabilities

Update existing
Draft
Tags
Categories
Featured image
Scheduled publish
Delete

Troubleshooting

OAuth redirect errors on Connect
Your Webflow workspace may have SSO or third-party-app restrictions enabled. Ask your workspace admin to allow KwikScaleAI in Webflow → Workspace Settings → Integrations, or temporarily disable the restriction for first connect.
429 Rate limit from Webflow
Webflow enforces 60 req/min per auth token. Normal KwikScaleAI usage is well below that. If you're hitting limits, you likely have another integration on the same token also publishing — either stagger the cadence or request a limit bump from Webflow support.
400 'field slug not found'
Your field mapping references a slug that doesn't exist in the collection. Pop into Webflow Designer, check the actual API slugs of each field, and update the mapping. Most common cause: display name 'Post Body' but the API slug is 'post-body' (or 'body' depending on what Webflow auto-generated).
Articles created but not visible on site
You're in draft mode (publishMode: 'draft') but haven't clicked Publish Site in Webflow Designer, or your site template doesn't bind this collection to a page template. Fix: switch to 'live' mode, or manually publish.
Featured image upload fails
Webflow expects an image URL (not a file). KwikScaleAI provides this via its asset pipeline. If the image URL is unreachable by Webflow's servers (localhost, private CDN without public access, temporary blob URL), Webflow rejects the field. Make sure images are served from a publicly accessible HTTPS origin.

FAQ

How is Webflow authenticated — OAuth or API token?
OAuth. You click Connect, authorize KwikScaleAI in Webflow's consent screen, and the token is stored server-side. No refresh flow needed — Webflow issues long-lived tokens for this scope.
Do I need a Webflow site plan to use this?
Yes. You need a Webflow site with CMS enabled — that's on Site Plans (CMS tier or higher). Workspace plans don't affect CMS availability. The CMS API is a per-site feature.
What's the field mapping and why do I need it?
Webflow CMS collections are fully custom — every site has different field slugs (e.g. 'post-body', 'article-content', 'content'). The field mapping tells KwikScaleAI which of your collection fields corresponds to title, body, slug, summary, featured image, and publish date.
Does the article go live immediately?
Depends on publishMode: 'live' uses Webflow's live-publish API and the article is public right after. 'draft' creates the item without publishing — you still need to click Publish Site in Webflow Designer to push it live.
Can KwikScaleAI upload featured images?
Yes — Webflow is the one adapter that supports featured images in v1. Configure the featuredImage field in your mapping and point it at an image-type field in your collection.

Ready to automate publishing?

Connect your site once. KwikScaleAI researches, writes, and publishes SEO content on autopilot.

Get started free