Webflow

Webflow CMS Skill

Credentials

• API Token: ${WEBFLOW_API_KEY}
• Site ID: 68f612cac31a6f533ce5528d
• Site: berendstrik.webflow.io

Image Upload Workflow

OPTION 1: Webflow Native (PREFERRED — but requires asset upload permission)

const { WebflowClient } = require('webflow-api');
const fs = require('fs');

const client = new WebflowClient({ 
  token: process.env.WEBFLOW_API_TOKEN
});

async function uploadAsset(filePath, fileName) {
  const fileBuffer = fs.readFileSync(filePath);
  const arrayBuffer = fileBuffer.buffer.slice(
    fileBuffer.byteOffset, 
    fileBuffer.byteOffset + fileBuffer.byteLength
  );
  
  return await client.assets.utilities.createAndUpload(
    '68f612cac31a6f533ce5528d',
    { file: arrayBuffer, fileName }
  );
}

⚠️ NOTE: The Personal Access Token may not have asset upload permissions (401 Unauthorized). If this fails, use Zernio workaround below.

OPTION 2: Zernio Workaround (RECOMMENDED when native fails)

# 1. Upload to Zernio
zernio media:upload /path/to/image.jpg
# Returns: {"url": "https://media.zernio.com/temp/..."}

# 2. Use the Zernio URL in Webflow PATCH
curl -X PATCH "https://api.webflow.com/v2/collections/<ID>/items/<ITEM_ID>" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"fieldData": {"cover": {"url": "https://media.zernio.com/temp/..."}}}'

Collections

Museums Collection

• Collection ID: 69ce595b57060eb28a767604
• Fields: name, slug, museum-description, cover (Image), article (RichText), url-naar-collectie (Link), city (PlainText), pic-1 (Image)
• Item IDs: See museums section below

Events Collection

• Collection ID: 69bfd230ceecbebceff82be0
• Fields: name, date-time, location, location-link, gallery, cover-image (Image), event-short-description, event-description, google-maps-embed (RichText), event-passed

Arts Collection

• Collection ID: 69bfd1ac805e504d421e717e
• Fields: title, slug, category, image (Image), description

FAQs Collection

• Collection ID: 69bfcf6e010a4c52f2a48c84

Common Operations

# List collections
curl -s "https://api.webflow.com/v2/sites/<SITE_ID>/collections" \
  -H "Authorization: Bearer <TOKEN>"

# Get items
curl -s "https://api.webflow.com/v2/collections/<COLLECTION_ID>/items?limit=20" \
  -H "Authorization: Bearer <TOKEN>"

# Update item (PATCH)
curl -s -X PATCH "https://api.webflow.com/v2/collections/<COLLECTION_ID>/items/<ITEM_ID>" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"fieldData": {"field-slug": "value"}}'

# Update image field
curl -s -X PATCH "https://api.webflow.com/v2/collections/<COLLECTION_ID>/items/<ITEM_ID>" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"fieldData": {"cover": {"url": "https://..."}}}'

# Publish site
curl -s -X POST "https://api.webflow.com/v2/sites/<SITE_ID>/publish" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{}'

Museums (11 items)

Events (5 items)

Error Codes

• 401: Invalid token or no asset upload permission
• 404: Collection/item not found
• 429: Rate limited — wait 60s
• validation_error: Missing required field

Notes

• Image fields use {"url": "..."} format, not plain URL string
• RichText fields need valid HTML
• Asset upload via native API may fail with 401 if token lacks permissions → use Zernio workaround