Webflow Integration

Overview

Webflow is a visual web design platform with a powerful CMS. Publish Owl connects to Webflow's CMS API v2 to create and update collection items in your blog, letting you publish AI-generated content directly to your Webflow site.

Requirements

  • A Webflow site with a CMS collection for blog posts
  • A Webflow API token with CMS read/write access
  • Your collection must have a rich text field for article content

Step 1: Get Your Site ID and Collection ID

Site ID

Go to Project Settings → General in the Webflow Designer. Your Site ID is displayed there.

Collection ID

Go to CMS Collections in the Designer, click your blog collection, then go to its Settings. The Collection ID is shown in the URL or settings panel.

Step 2: Generate an API Token

  1. Go to Site Settings → Apps & integrations → API access
  2. Click Generate API token
  3. Grant the following permissions:
    • CMS — Read and Write
    • Sites — Read (needed to determine your site URL)
  4. Copy the token

Step 3: Add Your Webflow Site

  1. In Publish Owl, go to Sites
  2. Click + Add Site
  3. Enter a name for your site
  4. Select Webflow as the CMS type
  5. Fill in:
    • Site ID: From Project Settings
    • Collection ID: From your blog collection settings
    • API Token: The token from Step 2
    • Content Field Slug: The slug of your rich text field (default: post-body)
    • Featured Image Field Slug: The slug of your image field (optional, e.g., hero-image)
  6. Click Auto-detect Field Slugs to automatically find the correct field names
  7. Click Save Site
Tip: Use the "Auto-detect Field Slugs" button to automatically identify your collection's rich text and image fields. If your collection has multiple rich text fields, you'll be able to select the correct one from a dropdown.

Supported Features

  • Title — Maps to the "Name" field in Webflow
  • Content — HTML published to your chosen rich text field
  • Slug — Custom URL slug
  • Featured Image — External URL set on your chosen image field
  • Status — Publish immediately or save as draft

Limitations

  • No scheduled publishing: Webflow's CMS API doesn't support scheduling. Articles are published immediately or saved as drafts.
  • No categories/tags: Categories and custom fields are not yet supported. Manage these in the Webflow Designer.
  • Collection structure dependent: Your collection must have a rich text field for content. Use "Auto-detect Field Slugs" to verify your setup.
Note: Publish Owl automatically sets the Name and Slug fields on your Webflow collection items. Make sure your collection has these standard fields.

Troubleshooting

Content field is empty after publishing

The content field slug may be incorrect. Click "Auto-detect Field Slugs" to find the right field name. Field slugs are lowercase with hyphens (e.g., "Main Image" becomes main-image).

403 Forbidden error

Your API token needs both CMS (read/write) and Sites (read) permissions. Regenerate the token with the correct scopes.

Published items not visible on site

Webflow requires you to publish your site for CMS changes to appear. Items created via the API are live in the CMS but won't appear on your published site until the next site publish.

Featured image not showing

Make sure you've specified the correct image field slug. The field must be of type "Image" in your Webflow collection schema.

Was this helpful?