Use Hoko with Webflow

Webflow is currently a manual CMS recipe. Hoko writes the exact short URL and link ID to two editable fields, then reads the same item back.

Before you start

  • Use a Webflow site where you can edit CMS items.
  • Create editable PlainText fields named hoko-short-url and hoko-link-id.
  • Prepare a site token for a private pilot, or a registered OAuth grant with authorized_user:read, sites:read, cms:read, and cms:write.
  • Choose a collection and item that you can update.

Set up the mapping

  1. Save the item’s current fieldData, isDraft, and isArchived values.
  2. Open the Webflow setup guide from Dashboard → Integrations → Apps. The current path uses a site token or registered OAuth grant; it is not a one-click marketplace connection.
  3. Select the site, collection, and item. Keep the Webflow collection ID separate from the Hoko collection ID.
  4. Run the staged update with isDraft: true.
  5. Read the same item back and confirm both Hoko fields and the item ID.

Verify the result

Confirm that the live published version did not change. Publish the staged item only when your editorial process is ready. If you use a webhook, verify its timestamp and signature before accepting it.

Troubleshoot and clean up

  • 403 usually means the token lacks CMS write access or the site is wrong.
  • A missing field means the field slug or collection is wrong.
  • Restore the saved item state and verify the final readback.

Open Apps · Technical reference · All app guides