Webflow Integration Guide

Last updated:

Overview

The Webflow integration allows you to publish articles from tryMarketr directly to your Webflow CMS collections. This is perfect for managing blog content created in tryMarketr and automatically publishing it to your Webflow site.

Prerequisites

  • Webflow account with CMS access
  • Existing Webflow site with a blog collection
  • Site Designer or higher permissions

Setup Guide

Step 1: Generate API Token

  1. Log into your Webflow account
  2. Click on your profile picture in the top-right corner
  3. Select Account Settings
  4. Navigate to Integrations tab
  5. Scroll to API Access
  6. Click Generate new token
  7. Give it a name: tryMarketr Integration
  8. Copy the generated token immediately

Important

Your API token is shown only once. Store it securely. If you lose it, you'll need to generate a new token.

Step 2: Find Your Site ID

You can find your Site ID in several ways:

  1. From Site Settings:
    • Open your site in the Webflow Designer
    • Click the settings icon (gear)
    • Go to General tab
    • The Site ID appears in the URL or settings panel
  2. From URL:
    • When editing your site, look at the URL
    • Format: https://webflow.com/design/{SITE_ID}

Step 3: Find Your Blog Collection ID

  1. In the Webflow Designer, click the CMS icon in the left panel
  2. Find your blog collection (often named "Blog Posts" or similar)
  3. Click on the collection name
  4. In the URL, locate the collection ID after /collections/
  5. Example: https://webflow.com/design/{SITE_ID}?collections={COLLECTION_ID}

Step 4: Configure in tryMarketr

  1. In tryMarketr, navigate to Integrations
  2. Click Add Integration
  3. Enter a display name (e.g., "My Webflow Site")
  4. Select Webflow as the platform
  5. Fill in the required fields:
    • API Token: From Step 1
    • Site ID: From Step 2
    • Blog Collection ID: From Step 3
    • Published Domain: Your site's domain (optional, e.g., myblog.com)
  6. Click Create Integration
  7. Click Test Connection to verify

API Reference

Authentication

Webflow uses Bearer Token authentication with your API token.

Authorization: Bearer {api_token}

API Endpoints Used

Validate Credentials

GET /sites/{site_id}

Verifies API token and retrieves site information.

Create CMS Item

POST /collections/{collection_id}/items

Creates a new blog post in your CMS collection.

Publish Site

POST /sites/{site_id}/publish

Publishes the site to make CMS changes live.

Update CMS Item

PATCH /collections/{collection_id}/items/{item_id}

Updates an existing blog post.

Delete CMS Item

DELETE /collections/{collection_id}/items/{item_id}

Removes a blog post from the collection.

Publishing Workflow

Webflow requires a two-step process:

  1. Create or update the CMS item
  2. Publish the site to make changes live

tryMarketr handles both steps automatically when you publish an article.

API Version

tryMarketr uses Webflow CMS API v1.0.0.

Troubleshooting

Error: "Invalid API token"

The API token is incorrect or has been revoked.

Solution: Generate a new API token from your Webflow account settings and update the integration in tryMarketr.

Error: "Site not found"

The Site ID is incorrect or you don't have access to that site.

Solution: Verify the Site ID is correct. Ensure your API token has access to the site. Site IDs are specific to each Webflow workspace.

Error: "Collection not found"

The Collection ID is incorrect.

Solution: Double-check your Blog Collection ID. Make sure you're using the ID from the URL, not the collection name.

Error: "Required field missing"

Your Webflow collection has required fields that aren't being populated.

Solution: Ensure your blog collection has the following fields: Name (title), Slug, and Post Body (rich text). Remove any other required fields or set default values in Webflow.

Publishing Delays

Changes may take a few minutes to appear on your live site.

Note: Webflow's publishing process can take 1-3 minutes depending on site complexity. If content doesn't appear immediately, wait a few minutes and refresh.

Collection Field Mapping

tryMarketr maps article fields to Webflow CMS fields as follows:

tryMarketr Field Webflow Field Type
Title Name Plain text
Content Post Body Rich text
Auto-generated Slug URL slug
Hero Image Main Image Image