Skip to main content

​
1. Overview

Webflow connector publishes Skayle posts to a selected Webflow CMS collection. It requires:
  • siteId
  • token
  • collectionId
  • fieldMapping
  • taxonomyMapping

​
2. Prerequisites

Before connecting:
  • A Webflow site
  • A CMS collection for blog posts
  • Separate collections for category/tag/author taxonomies
  • Reference fields in your post collection for taxonomy links

​
3. Creating API credentials

In Webflow:
  1. Open Site Settings -> Apps & Integrations -> API Access.
  2. Create a token for Skayle.
  3. Copy token and Site ID.
In Skayle connector settings, enter:
  • Site ID
  • API token

​
4. Required permissions

Token should have read and write access for:
  • Assets
  • CMS
  • Pages
  • Sites
If permissions change, regenerate the token and update it in Skayle.

​
5. CMS-side setup

Create/confirm:
  • Main post collection with fields for title, slug, excerpt, and rich text content
  • Image/File field for featured image (if used)
  • Optional publish date/status fields
  • Category/tag/author collections
  • Reference fields in post collection linking to those taxonomy collections
No webhook setup is required.

​
6. Connecting in Skayle

  1. Open Settings -> Connector.
  2. Select Webflow.
  3. Enter Site ID and token, then test connection.
  4. Select post collection.
  5. Map Skayle fields to Webflow field slugs.
  6. Map taxonomy collection IDs for category/tag/author.
  7. Save connector.

​
7. Field mapping explanation

Required mappings:
  • Title
  • Slug
  • Excerpt
  • Content
Optional mappings:
  • Featured image
  • Publish date
  • Status
Taxonomy mapping expects collection IDs for:
  • Category collection
  • Tag collection
  • Author collection
Publish behavior:
  • Published posts are created/updated as live items.
  • Draft posts remain non-live.

​
8. Publishing test article

  1. Create a draft post in Skayle.
  2. Assign category/tag/author.
  3. Publish from Skayle.
  4. Confirm item appears in selected Webflow collection.
  5. Verify item is live if published.
  6. Verify taxonomy references resolve correctly.

​
9. Common errors & troubleshooting

IssueLikely causeFix
Permission denied / missing scopesToken scopes incompleteGrant required scopes and regenerate token
Slug already exists on republishCached slug after unpublish/deleteRepublish your Webflow site, then retry
Featured image not attachedMapped field is not Image/FileMap to a valid Image/File field
Missing taxonomy linksReference fields or taxonomy mapping missingAdd reference fields and verify collection mappings
Collection not foundWrong collectionId or site mismatchRe-select collection from schema step

​
10. Best practices

  • Use dedicated taxonomy collections with stable IDs.
  • Keep slug conventions consistent to reduce collisions.
  • After major unpublish/delete operations, republish site when needed.
  • Validate one full publish/update/unpublish cycle before bulk publishing.