webflow-common-errors

Featured

Diagnose and fix Webflow Data API v2 errors — 400, 401, 403, 404, 409, 429, 500. Use when encountering Webflow API errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "webflow error", "fix webflow", "webflow not working", "debug webflow", "webflow 429", "webflow 401".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Webflow Common Errors ## Overview Quick reference for the most common Webflow Data API v2 errors, their root causes, and concrete solutions. Covers every HTTP status code the API returns. ## Prerequisites - `webflow-api` SDK installed - API token configured - Access to application logs ## HTTP Error Reference ### 400 Bad Request — Invalid Input ``` { "code": "validation_error", "message": "Invalid field data" } ``` **Common causes:** - Missing required field (`name` and `slug` are always required for CMS items) - Wrong field type (sending string for a Number field) - Invalid slug format (must be lowercase, hyphens only, no spaces) - Bulk request exceeds 100 items **Fix:** ```typescript // Check collection schema before creating items const collection = await webflow.collections.get(collectionId); const requiredFields = collection.fields?.filter(f => f.isRequired); console.log("Required fields:", requiredFields?.map(f => `${f.slug} (${f.type})`)); // Validate slug format function isValidSlug(slug: string): boolean { return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug); } ``` --- ### 401 Unauthorized — Invalid Token ``` { "code": "unauthorized", "message": "Not authorized" } ``` **Common causes:** - Token revoked or expired - Token copied with extra whitespace - Using v1 API key format with v2 endpoints **Fix:** ```bash # Verify token works curl -s https://api.webflow.com/v2/sites \ -H "Authorization: Bearer $WEBFLOW_API_TOKEN" \ -w "\nHTTP Status: %{http_cod...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category