webflow-common-errors

# 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...