Sign in
WhatsApp Flows

Create flow

Create a new WhatsApp Flow in DRAFT status. Optionally clone an existing flow. After creating, upload a Flow JSON definition, then publish to make it sendable.

post/v1/whatsapp/flows

Request body

accountIdstring required

WhatsApp social account ID

namestring required

Flow display name

categoriesstring[] required

Flow categories

cloneFlowIdstring

Optional: ID of an existing flow to clone the Flow JSON from

asVersionboolean

When cloning, true keeps the clone in cloneFlowId's version lineage (auto-numbered next version); false/absent creates an independent flow. Ignored without cloneFlowId.

endpointUristring uri

HTTPS-only data exchange endpoint for the flow. Settable only while the flow is in DRAFT, and the flow's uploaded Flow JSON must declare data_api_version "3.0" for the endpoint to be used.

Response

Flow created

successboolean

Example response

{
  "flow": {
    "status": "DRAFT"
  }
}

Changes

Changed in 1 of the 26 revisions of this API.1