Skip to main content
Every WhatsApp Flow declares the version of Flow JSON it’s written in, and endpoint Flows also declare a Data API version. Meta adds features in new versions and retires old ones in two steps: a frozen version can’t be published any more, and an expired version can’t be sent or opened. Keeping Flows on a supported version is what keeps them working.
In Flowella. Supported. Flowella writes every Flow in Flow JSON 7.3, the latest version, and HubSpot-form Flows use Data API 3.0. Flowella doesn’t move published Flows to a new version by itself: a Flow uses the version Flowella writes at the time you next sync or publish it.

The three versions

A change in the first number is a breaking change, so a Flow may need edits to move to it. A change in the second number adds features without breaking anything. After 1.9 comes 1.10, not 2.0.

Frozen and expired

Meta usually gives about 90 days’ notice before a version freezes or expires, and announces dates in the Flows changelog. It can act faster for security reasons, and can skip the frozen step entirely.

Where versions stand

Meta’s Flows changelog was last updated on 11 November 2025. Check it before you plan a migration. Data API 4.0, released in November 2025, adds an optional signature that proves each endpoint request came from someone who received the Flow message. Data API 3.0 remains supported.

Breaking changes to know about

What to do when Meta announces a freeze

  • Flows built in Flowella use the version Flowella writes. When Flowella moves to a newer version, sync or publish each Flow again to move it across.
  • Flows built in WhatsApp Manager or another tool need updating there before the version expires. Meta shows warnings in its Flow builder and sends version warning webhooks.
  • Before a version expires, replace any template whose Flow is still on it, or customers who tap the button can’t open the Flow.

WhatsApp Flows overview

How Flows and their states work.

Flow components and limits

What each version can show.

Flow endpoints and security

Data API versions in practice.

Platform changes

Upcoming Meta changes that affect Flowella.
Checked against Meta’s documentation on 18 November 2026: Versioning and the WhatsApp Flows changelog.
Last modified on November 18, 2026