---
title: "Create Flow API"
method: POST
path: "/v3/metainfo/flow/create"
tags: ["WhatsApp Flows"]
---

# Create Flow API

`POST /v3/metainfo/flow/create`

The **Create Flow API** allows you to create interactive WhatsApp flows using Meta's flow builder JSON structure. 
This API accepts flow configuration details such as flow name, categories, and a valid flow JSON string. 
Optionally, flows can be published immediately upon creation. It is used to build dynamic, guided experiences 
for WhatsApp users, such as onboarding journeys, service requests, or feedback forms.

## Headers

- `Content-Type` string, required

## Request body

- object
  - `name` string, required — Name of the flow.
  - `categories` string[], required — Categories to which the flow belongs.
  - `flow_json` string, required — JSON string representing the WhatsApp flow structure.
  - `publish` boolean — Whether to publish the flow immediately. Values can be 'true' or 'false'. Default value is 'false'.

## Response `200`

Successfully created flow

- CreateFlowSuccessResponse
  - `status` string, required
  - `message` string, required
  - `data` object, required
    - `id` string, required
    - `success` boolean, required

## Other responses

- `400` — Bad Request - Missing Data or Invalid JWT Token
- `500` — Internal Server Error
- `4XX` — Meta Flow Creation Error

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)