Skip to main content

Webflow API Key Permission Scopes

Your Webflow API token must include the correct scopes or publishing will fail.

Required scopes​

Jottler integration requires:

  • CMS: read and write
  • Sites: read
  • Assets: read and write

Why each scope matters​

  • CMS: read and write: create and update CMS items.
  • Sites: read: list/select the target Webflow site.
  • Assets: read and write: upload and reference media assets used in content.

Symptoms of missing scopes​

  • Connection succeeds but publish fails.
  • Unauthorized errors during create/update.
  • Media upload failures or missing images.
  • Site/collection cannot be listed in integration setup.

How to fix scope issues​

  1. Generate a new token in Webflow with all required scopes.
  2. Reconnect token in Settings -> Integrations -> Webflow.
  3. Refresh mapping and run a test publish.

Security best practices​

  • Use a dedicated token for Jottler integration.
  • Rotate tokens periodically.
  • Revoke old/unused tokens immediately.