---
title: "Create flow version"
method: POST
path: "/whatsapp/flows/{flow_id}/versions"
tags: ["WhatsApp Flows"]
---

# Create flow version

`POST /whatsapp/flows/{flow_id}/versions`

Upload new flow JSON to create a new version. Syncs with Meta's API.

## Request body

- WhatsappFlowVersionCreateRequest
  - `flow_json` object, required — WhatsApp Flow JSON definition
  - `phone_number_id` string — Override phone number (optional)

## Response `201`

Version created

- WhatsappFlowVersionDetailResponse
  - `data` WhatsappFlowVersionDetail, required
    - `id` string, uuid, required
    - `version_label` string, required — Version identifier
    - `status` 'draft' | 'published', required
    - `flow_json_sha` string, nullable — SHA256 hash of flow JSON
    - `published_at` string, date-time, nullable
    - `validation_errors` object[], nullable — Meta validation errors
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `flow_json` object — WhatsApp Flow JSON definition

## Other responses

- `401` — Missing or invalid API key
- `404` — Resource not found
- `422` — Validation failed

---

[API](https://skmtc.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)