On 29 August 2023, Webflow released version 2 of their Data API. Cloudpress uses the Data API to export content to your Webflow site. Until recently, Cloudpress supported only Version 1 of the Webflow Data API, but on 1 February, we released support for the Webflow Data API V2.
In this blog post, we’ll briefly discuss the differences between the two versions of the Webflow Data API and walk you through upgrading your Webflow connection to use Version 2 of the Webflow Data API.
Differences between Version 1 and Version 2 of the Webflow Data API
One of the changes with Version 2 of the API is that Webflow now differentiates between two sets of APIs: the Data API and the Designer API. The Designer API is new in version 2 and is used to develop extensions for the Webflow Designer.
The Data API is a REST API that allows developers to query and manage data such as your CMS Collections, Pages, Users, etc. This is the API that Cloudpress uses to export content to Webflow and is the new version of the Webflow Version 1 API.
Webflow also updated several endpoints on the Data API and added new endpoints to expose extra functionality to developers. At this moment, none of the new or updated endpoints benefit Cloudpress. Still, they are working on adding endpoints for the new localization features they added, and we intend to support those as soon as they are available.
Another new feature of the version 2 API is the use of scopes. This allows developers to be more specific about the type of data they want to read and update. It also means that you, as a user, can see exactly the type of data an external application wants to update.
Here is an example of the old authorization dialog. And here is the new dialog with the scopes that indicate the data the application intends to update.
Upgrading your connection to Version 2
First, let’s talk about why you want to upgrade your Webflow connection to use Version 2 of the API. The main is that version 2 is the only one getting updates. This means that new features like localization will only be available in version 2 (it is not yet available when writing this blog post).
So, if you want to use the latest Webflow features, you must update your connection.
Due to the addition of scopes, we cannot upgrade your connection manually from version 1 to version 2. Webflow requires you to reauthorize applications so that you can be aware of the scopes required by those applications.
The upgrade process itself is simple. Open your connection and navigate to the Connection tab. You will see an option to upgrade your connection to version 2 of the Webflow API. Click on the upgrade button. This will open a popup window and navigate you to the Webflow website, where you will be prompted whether you want to give Cloudpress access to your website. On the left-hand side, you will see the scopes required by Cloudpress. On the right side, you will see the list of sites. Make sure to select the correct side that your connection is using and click the Authorize App button.
You will be returned to the Cloudpress website and can continue using your Webflow connection to export content as before.
BTW, we have also added a warning message during export. When you export a document with a connection that still uses version 1 of the Webflow API, you will see a warning message prompting you to upgrade to version 2. Clicking the link in the log will navigate you directly to the connection, where you can follow the upgrade process described above.
In this blog post, we discussed our support for Version 2 of the Webflow Data API and the upgrade process you must follow. As new features, such as localization, become available in the API, we hope to support those.