> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Flow JSON

> Structure of WhatsApp Flow JSON

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

## Structure

```json theme={null}
{
  "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](https://developers.facebook.com/docs/whatsapp/flows/reference/components) for the full list.

## Meta documentation

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

<Card title="Meta Flow JSON reference" icon="arrow-up-right-from-square" href="https://developers.facebook.com/docs/whatsapp/flows/reference/flowjson">
  Official documentation from Meta
</Card>