How can I fix the "Bad Request" and "ValidationError" error I am getting when trying to send a POST request from Zapier to Webflow using API integration?
TL;DR
- Ensure all required CMS fields in Webflow are included and correctly formatted in Zapier.
- Use Webflow’s internal IDs for reference fields and validate your JSON structure matches API expectations.
- Test via Postman to isolate issues and examine error messages for specific field problems.
You're encountering "Bad Request" or "ValidationError" because the data you're sending from Zapier to Webflow doesn't match Webflow's expected schema for the API endpoint.
1. Check Webflow API Requirements
- Go to Webflow’s API reference at developers.webflow.com.
- Identify the correct endpoint for your use case (e.g., Create Item in CMS Collection).
- Review required fields, expected data types, and formatting (text, images, references, etc.).
2. Validate Collection Field Requirements
- In Webflow, go to CMS and open the target Collection.
- Check for:
- Required fields (marked with a red asterisk).
- Slug fields, which must be URL-safe (lowercase, no spaces/special characters).
- Reference or multi-reference fields, which require CMS item IDs, not names.
- Image fields, which require a valid image URL or Webflow asset.
3. Check Zapier Configuration
- In your Zap:
- Ensure all required fields are included in the POST body.
- Map data properly using Zapier's interface — dropdowns for reference fields must map to Collection Item IDs.
- Use Webhooks by Zapier → Custom Request if you’re building raw JSON.
- Set the content type to
application/json.
4. Send Proper JSON Structure
- The body should follow this format:
- Top-level
fieldsobject that matches Webflow's field keys. - Example:
{ "fields": { "name": "Example", "slug": "example", "reference": "63cdbf11b8XXXXXX" } }
- Do not include fields that are not in the Collection schema.
- Use
live: trueonly if the item should be published immediately.
5. Test with Webflow API Directly
- Use Postman or curl to test the same request outside of Zapier.
- If it works there, the error is likely due to how Zapier formats or sends the request.
6. Review the Full Error Message
- Zapier usually includes a response body with details.
- Look for specific field names mentioned in the error — it tells you which field caused the ValidationError.
- Example message:
"ValidationError: Field 'slug' is required"means your payload is missing that field.
Summary
To resolve the "Bad Request" or "ValidationError" from Webflow’s API in Zapier, ensure that your POST request:
- Includes all required CMS fields,
- Uses correct data types and formats,
- References related items by Webflow’s internal IDs, and
- Follows the correct JSON structure expected by Webflow’s API.
Testing with Postman and carefully reviewing error messages helps pinpoint the exact issue.
