Webflow

1. In Webflow: Site settings → Apps & integrations → API access → generate a site token with Pages: read and write.
2. In the dashboard, open your site → Webflow, and paste the token and your Webflow site id.
3. In Webflow: Site settings → Apps & integrations → Webhooks → add a Site publish webhook with your site's hook URL.

On each publish Headlark reads every published page and writes its SEO title, meta description and Open Graph title and description through Webflow's API. Webflow serves them from your next publish: Headlark never publishes for you, because that would also ship your drafts. Pages whose SEO didn't change aren't written again.

• Pages Headlark leaves alone: CMS collection template pages (their SEO is bound to collection fields), Webflow's utility pages (404, password, search results), drafts and archived pages.
• A publish to the webflow.io staging domain only is ignored. Add your custom domain to the site in the dashboard; publishes that include it are processed.
• Localized sites: the primary locale is written; secondary locales aren't yet.
• Webflow allows 60 to 120 API requests a minute depending on your site plan. Headlark waits when Webflow asks it to; pages it couldn't write are picked up by the next publish.
• If the token is revoked or lacks Pages: read and write, the results say so. Generate a new one and paste it in the dashboard.

Webflow's API can't set a page's Open Graph image, so the default share image doesn't reach Webflow pages. Set one in each page's settings in the Designer (Open Graph settings → image URL).

Structured data and alt text aren't part of Webflow's page settings. To get those too, add the snippet in Site settings → Custom code → Head code.

With review mode on, new SEO waits in the dashboard instead of being written. Approving a page writes its fields through the API right away, and your next publish puts them live.

Your Webflow token is stored encrypted and is never shown again.