---
title: "POST /v1/whatsapp/flow/create"
method: POST
path: "/v1/whatsapp/flow/create"
---

# POST /v1/whatsapp/flow/create

`POST /v1/whatsapp/flow/create`

Creates a new WhatsApp Flow. Flows enable businesses to create rich, interactive forms and experiences that users can complete without leaving WhatsApp. The Flow is created in DRAFT status. If <code>publish</code> is set to <code>true</code> and a valid <code>flowJson</code> is provided, the Flow is published immediately.

## Request body

- object
  - `id` string, required — The ID of the WhatsApp Business Account to associate with this Flow.
  - `flowName` string, required — The name of the Flow. Must be unique within the WhatsApp Business Account.
  - `categories` MetaFlowCategory[], required — The categories that classify the business purpose of the Flow. At least one category is required.
  - `flowJson` string — The Flow JSON definition that describes the screens, components, and logic of the Flow. Maximum size is 10 MB.
  - `publish` boolean — Set to <code>true</code> to publish the Flow immediately after creation. Requires a valid <code>flowJson</code> that passes Meta's validation.
  - `cloneFlowId` string — The ID of an existing Flow within the same WhatsApp Business Account to clone.

## Response `200`

Success

- CreateWhatsAppFlowOutput
  - `flowId` string — The unique identifier assigned to the Flow by Meta.
  - `validationErrors` MetaFlowValidationError[] — A list of validation errors returned by Meta, if any. Validation errors must be resolved before the Flow can be published.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — InvalidParametersException
- `484` — AccessDeniedByMetaException
- `485` — ThrottledRequestException
- `486` — InternalServiceException
- `487` — DependencyException

---

[API](https://skmtc.net/aws/apis/socialmessaging.md) · [All operations](https://skmtc.net/aws/apis/socialmessaging/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/socialmessaging/versions/127e73cd9a15/schema)