How to connect Webflow to Koala AI
Koala AI publishes articles into a Webflow CMS Collection as draft items. You need an API token for your site and a Collection with a Rich Text field for the article body. If the Collection has no Rich Text field, Koala AI can add one for you during setup.
Step 1: Create an API token in Webflow
- In Webflow, open your site's Site settings, then the Apps & Integrations tab, then API access.
- Click Generate API token.
- Name it "Koala AI". Set Sites to Read-only and CMS to Read and write.
- Click Generate token and copy it.
If your site has no Collection for blog posts yet, create one in Webflow first (the Blog Posts template works).
Step 2: Connect in Koala AI
- Go to your Account page and scroll to Integrations.
- Click Connect next to Webflow.
- Enter your Webflow site domain: your
.webflow.ioaddress or your custom domain. - Paste your Webflow API token.
- Click Load collections. Koala AI finds your site and lists its Collections. A Collection with "blog", "post" or "article" in its name is selected for you.
- Under Collection, choose the Collection your blog posts live in.
- Under Post body field, choose the Rich Text field the article goes into. If the Collection has none, click Create a "Post Body" field for me.
- Click Connect Webflow.
Already know your Collection ID? Click Have a Collection ID? Enter it instead, paste it, and click Load fields.
Step 3: Publish an article
- Open a finished article in KoalaWriter.
- Click Create Draft above the article. If you have more than one integration, pick your Webflow site from the list.
- When you see Webflow draft created., open the Collection in Webflow to review and publish the item.
Each item gets the article title as its Name, a slug made from the target keyword, and the article in the body field you chose. Koala AI always creates Webflow items as drafts, including when articles publish automatically. To set that up, see How to automatically upload articles to your website.
Troubleshooting
"Webflow returned HTTP 400 ... post-body: Field not described in schema"
Your connection was set up before the guided setup existed, so it sends the article to a field named post-body, and your Collection's body field has a different name.
- On your Account page, under Connected Integrations, click the trash icon on the Webflow row to disconnect it.
- Connect Webflow again with the steps above and choose your Rich Text field under Post body field.
- If you used the old connection elsewhere, pick the new one there too: the Publishing integration in your Brand DNA settings and the Integrated Account on your folders.
"This API token is missing a permission Webflow needs"
Generate a new token with Sites set to Read-only and CMS set to Read and write.
"Webflow rejected this API token"
The token was copied partly or has been revoked. Copy it again or generate a new one.
"None of the sites this token can access use the domain ..."
The message lists the domains the token can see. Enter one of them as the Webflow site domain, or generate the token from the site you want to publish to.
"This site has no CMS Collections yet"
Create a Collection in Webflow, then click Reload collections.
Still stuck? Contact us through the chat on koala.sh or email hello@koala.sh with the full error message.
Updated on: 09/11/2026
Thank you!