Webflow integration

Connect a Webflow CMS collection so Blogflair can create or update items (blog posts) via the Webflow API.

API token (Webflow)

1. In Webflow, open your site’s Apps & Integrations area: https://webflow.com/dashboard/sites/your-site-name/integrations Replace your-site-name with your site’s dashboard slug (the segment Webflow uses in that URL for your project).
2. Generate an API token: (or create one scoped for this use). When Webflow asks which permissions the token needs, enable CMS access with at least read and edit (write) so Blogflair can list collections/fields and publish items.
   
   
3. Copy the token once and store it securely — Webflow may not show the full secret again.

Required in Blogflair

• Site URL — your Webflow site (e.g. https://yoursite.webflow.io or your custom domain; with or without https://).
• API token — from the step above.
• Collection ID — from Webflow: open the CMS collection you publish into → Settings (or collection details) and copy the Collection ID.
  
  

Setup steps

1. Complete API token above with CMS read + edit scopes.
2. In Blogflair: Dashboard → Integrations for your brand → Webflow.
3. Enter site URL, API token, and Collection ID → save.
4. Load collection fields (if shown), map Blogflair fields (title, body, etc.) to Webflow CMS fields → save mappings.
5. Test connection before publishing from Articles.

Collection setup

Match your CMS collection to what Blogflair sends (title, slug, body, summary, tags, etc.). Field types (e.g. rich text vs plain text) should align with your mappings or publishes can fail or look wrong.

Common issues

• 403 / permission errors — Token missing CMS read/edit; generate a new token with the right scopes.
• Wrong site or collection — Double-check site URL and Collection ID for the collection you intend.
• Field errors — Collection missing mapped fields or incompatible field types.

Security tips

• One token per site/environment; revoke in Webflow when you disconnect or rotate.