Webflow Integration Guide
Connect Webflow so Nuwtonic can sync CMS items and pages, publish content, and apply optimization updates through the Webflow Data API.
Related docs: User Guide · Webflow docs: Site token
1. What this integration does
With Webflow connected, Nuwtonic can:
- sync CMS items and pages from your Webflow site;
- publish generated content into the selected CMS collection;
- apply approved SEO or content fixes through the CMS pipeline;
- keep one active CMS connection for the workspace.
You connect with:
- API token (site token)
- Collection ID for the CMS collection Nuwtonic should use
2. Before you start
- You are a site administrator on the Webflow site. Only admins can generate site tokens.
- The site already has a CMS collection for the content you want to sync or publish.
- You can open Site settings → Apps & integrations.
- No other CMS integration is active on the same Nuwtonic workspace.
Webflow limits:
- Each site can have up to 5 site tokens.
- Tokens expire after 365 consecutive days of inactivity.
- A token is shown only once when created. Store it immediately.
3. Create a Webflow site token
- Open your Webflow workspace and find the site.
- Open Site settings (gear icon).
- In the left sidebar, open Apps & integrations.
- Scroll to API access.
- Select Generate API token.
- Name the token clearly, for example
Nuwtonic. - Choose scopes with at least CMS read and write access. If you publish live items, include site publish permission as needed.
- Generate the token.
- Copy the token immediately into a password manager.
Recommended scope intent:
| Need | Permission direction |
|---|---|
| Read CMS items | CMS read |
| Create or update CMS items | CMS write |
| Publish site or items | Sites publish when required by your workflow |
Official reference: Intro to Webflow’s APIs.
4. Find the Collection ID
Nuwtonic needs the CMS Collection ID for the collection that should receive synced or published content.
Ways to find it:
- Open the Webflow Designer and inspect the CMS collection details for the collection ID.
- Or call the Webflow CMS collections API with your site token and copy the target collection
id. - Store that ID. It looks like a long alphanumeric string.
Use the collection that matches your blog posts, resources, or page items. Publishing to the wrong collection is a common setup mistake.
5. Connect Webflow in Nuwtonic
- Open the workspace.
- Go to Integrations.
- Find Webflow and select Connect.
- Paste the API Token.
- Paste the Collection ID.
- Select Connect.
- Confirm Webflow shows as Connected.
If connection fails, regenerate a token with broader CMS scopes and confirm the Collection ID belongs to the same site as the token.
6. Publishing and SEO fixes
- Generate or finalize content in Nuwtonic.
- Publish through the Webflow integration.
- In Webflow, confirm the CMS item was created or updated.
- Publish the item or site if your Webflow workflow keeps changes in draft until publish.
- Open the live URL and verify the content.
For SEO fixes:
- Run the audit or agent in Nuwtonic.
- Approve only the changes you want.
- Push the fix.
- Confirm the CMS fields and live page updated as expected.
7. Troubleshooting
API access section is missing
Your account is not a site administrator. Ask an admin to generate the token or upgrade your role.
Invalid token
- Confirm you copied the full token with no spaces.
- Confirm the token was not revoked.
- Generate a new token if the previous one expired from inactivity.
Collection not found
- Confirm the Collection ID is from the same site as the token.
- Confirm the collection still exists.
- Re-copy the ID from Webflow and reconnect.
Content updates stay in draft
Webflow may require an explicit publish step for CMS items or the site. Publish in Webflow after Nuwtonic writes the item.
Token limit reached
Revoke unused tokens under Site settings → Apps & integrations → API access, then create a new Nuwtonic token.
8. Production checklist
- Site admin generated a site token
- CMS read/write scopes enabled
- Correct Collection ID copied
- Webflow connected in Nuwtonic
- Test item created or updated successfully
- Live publish verified on a low-risk URL
9. Next steps
- Continue day-to-day workflows in the User Guide.
- Connect Google Search Console for search performance.
- Use Webhooks if you need a custom receiver outside Webflow CMS.
