Flow JSON

Flow JSON defines the screens, components, and navigation of your WhatsApp Flow.

Structure

{
  "version": "7.0",
  "data_api_version": "3.0",
  "routing_model": {
    "SCREEN_ONE": ["SCREEN_TWO"],
    "SCREEN_TWO": []
  },
  "screens": [
    {
      "id": "SCREEN_ONE",
      "title": "Welcome",
      "layout": {
        "type": "SingleColumnLayout",
        "children": []
      }
    }
  ]
}

Key fields

Field	Description
`version`	Flow JSON schema version (e.g., `7.0`)
`data_api_version`	Data API version for dynamic flows (e.g., `3.0`)
`routing_model`	Defines allowed screen transitions
`screens`	Array of screen definitions

Screen components

Screens contain layouts with children components. Common ones include:

TextHeading - Section headers
TextBody - Paragraph text
TextInput - Single-line input
TextArea - Multi-line input
Dropdown - Select from options
RadioButtonsGroup - Single selection
CheckboxGroup - Multiple selection
DatePicker - Date selection
Footer - Action buttons

Additional components like Image, EmbeddedLink, OptIn, and more are available. See Meta’s components reference for the full list.

Meta documentation

For the complete Flow JSON reference, component properties, and validation rules:

Meta Flow JSON reference

Official documentation from Meta

Data endpointServe dynamic data to WhatsApp Flows

Getting started

WhatsApp

For your team

Onboard customers

Automations

Structure

Key fields

Screen components

Meta documentation

Meta Flow JSON reference

​Structure

​Key fields

​Screen components

​Meta documentation

Meta Flow JSON reference

Structure

Key fields

Screen components

Meta documentation