Connect Webflow to CrawlTide

Connect your Webflow site (API v2), then map your blog collection so you can publish CrawlTide articles straight into Webflow.

Who this is for

Webflow site owners/admins on a CrawlTide Pro or Enterprise plan who want to push generated articles into a Webflow CMS collection (and update SEO metadata).

Prerequisites

  • A CrawlTide Pro or Enterprise plan.
  • A Webflow site with a CMS collection (e.g. Blog Posts).
  • Permission in Webflow to generate an API token for that site.

Step-by-step setup

1

Create a Webflow API token (v2)

In Webflow: Site settings → Apps & integrations → API access → Generate API token. Give it these scopes:

  • sites:read
  • cms:read
  • cms:write

Copy the token — you'll paste it into CrawlTide once.

2

Find your Site ID

In Webflow: Site settings → General → Site ID. (It's a long alphanumeric value.)

3

Connect Webflow in CrawlTide

Open your project → Settings → CMS Connections → Webflow → Connect Webflow, then paste your API token and Site ID. The token is stored encrypted and never shown again.

4

Configure article publishing (field mapping)

On the connected Webflow card, click Configure publishing:

  • Pick the target collection (e.g. Blog Posts).
  • Map CrawlTide fields to your collection's fields — title, slug and content are required; excerpt is optional.
  • Save. CrawlTide remembers the mapping per project.

Mapping is needed because every Webflow collection has its own field names (e.g. post-body, post-summary).

5

Publish an article (test with a draft first)

  • Open a generated article (status Draft) in the Content Planner.
  • Click Save as Webflow Draft — this creates a staged (unpublished) CMS item; nothing goes live.
  • Review it in the Webflow CMS → your collection. When happy, use Publish to Webflow to make it live (this publishes the item to your live site).

Troubleshooting

ProblemLikely causeFix
"Invalid Webflow API token" (401)The API token is wrong, expired, or revoked.Generate a new API v2 token in Webflow (Site settings → Apps & integrations → API access) and reconnect.
"Missing required permissions" (403)The token doesn't have the scopes CrawlTide needs.Recreate the token with sites:read, cms:read and cms:write scopes, then reconnect.
"Site or collection not found" (404)Wrong Site ID, or the token can't access that site.Check the Site ID (Site settings → General), and that the token belongs to the same site/workspace.
No collections found / can't pick a collectionThe site has no CMS collections, or the token lacks cms:read.Create a CMS collection (e.g. Blog Posts) in Webflow, and confirm the token has cms:read.
Required fields missing when saving the mappingTitle, slug and content must each be mapped to a collection field.In Configure Webflow publishing, map all three required fields. Excerpt is optional.
Item created but not visible on the live siteDrafts are staged (not published). Webflow also lists posts under Blog posts, not Manage blogs.Check the collection in the Webflow CMS (e.g. "Blog Posts"). Use "Publish to Webflow" (or publish the site) to make a draft live.
Duplicate slug errorWebflow requires a unique slug per collection.CrawlTide retries once with a unique suffix. If it still fails, change the article slug and retry.
Meta title / meta description not appearingWebflow does not expose item SEO meta as universal API fields — SEO is bound to collection fields in the Designer.Add Meta Title / Meta Description fields to the collection and bind them to the page's SEO settings in the Designer, then map them in CrawlTide.

Security notes

  • Never paste your API token into chat, tickets, or shared docs. Enter it only in the CrawlTide connect form.
  • CrawlTide stores your Webflow token encrypted at rest (AES-256) and never displays it again.
  • If a token is ever exposed, revoke it in Webflow and generate a new one, then reconnect.

Still stuck? We're happy to help.

Contact support