Skip to main content
POST

Authorizations

X-API-Key
string
header
required

Body

application/json
wabaId
string
required

WhatsApp Business Account ID.

Example:

"whatsapp-business-account-id"

name
string
required

Flow name.

Example:

"My first flow"

categories
enum<string>[]
required

Flow categories.

Category of the WhatsApp Flow.

  • SIGN_UP: For sign-up processes.
  • SIGN_IN: For sign-in processes.
  • APPOINTMENT_BOOKING: For booking appointments.
  • LEAD_GENERATION: For lead generation.
  • CONTACT_US: For contact forms.
  • CUSTOMER_SUPPORT: For customer support.
  • SURVEY: For surveys.
  • OTHER: For other purposes.
Available options:
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY,
OTHER
flowJson
string

JSON string of the Flow structure.

Example:

"{\"version\":\"5.0\",\"screens\":[{\"id\":\"WELCOME_SCREEN\",\"layout\":{\"type\":\"SingleColumnLayout\",\"children\":[{\"type\":\"TextHeading\",\"text\":\"Hello World\"},{\"type\":\"Footer\",\"label\":\"Complete\",\"on-click-action\":{\"name\":\"complete\",\"payload\":{}}}]},\"title\":\"Welcome\",\"terminal\":true,\"success\":true,\"data\":{}}]}"

publish
boolean
default:false

If true, the Flow will be created in PUBLISHED state.

cloneFlowId
string

ID of source Flow to clone. You must have permission to access the specified Flow.

Example:

"flow-id-to-clone"

endpointUri
string

The endpoint URI for the Flow.

Example:

"https://example.com/flow-endpoint"

Response

Successfully created a flow.

id
string

The ID of the created Flow.

Example:

"flow-1"

success
boolean

Whether the operation was successful.

Example:

true