Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1431213151.3 KB

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.

post/v1/whatsapp/flow/create

Request body

idstring required

The ID of the WhatsApp Business Account to associate with this Flow.

flowNamestring required

The name of the Flow. Must be unique within the WhatsApp Business Account.

categoriesMetaFlowCategory[] required

The categories that classify the business purpose of the Flow. At least one category is required.

flowJsonstring

The Flow JSON definition that describes the screens, components, and logic of the Flow. Maximum size is 10 MB.

publishboolean

Set to <code>true</code> to publish the Flow immediately after creation. Requires a valid <code>flowJson</code> that passes Meta's validation.

cloneFlowIdstring

The ID of an existing Flow within the same WhatsApp Business Account to clone.

Response

Success

flowIdstring

The unique identifier assigned to the Flow by Meta.

validationErrorsMetaFlowValidationError[]

A list of validation errors returned by Meta, if any. Validation errors must be resolved before the Flow can be published.