Skip to content

Upload flow JSON

Upload or update the Flow JSON for a DRAFT flow. The Flow JSON defines all screens, components (text inputs, dropdowns, date pickers, etc.), and navigation.

Meta validates the JSON on upload and returns any validation errors. See:

PUT /v1/whatsapp/flows/{flowId}/json

Upload or update the Flow JSON for a DRAFT flow. The Flow JSON defines all screens, components (text inputs, dropdowns, date pickers, etc.), and navigation.

Meta validates the JSON on upload and returns any validation errors. See: https://developers.facebook.com/docs/whatsapp/flows/reference/flowjson

Parameters

  • flowId (path, string) required — Flow ID

Request body

Content-Type: application/json

  • accountId (string) required — WhatsApp social account ID
  • flow_json (any) required — The Flow JSON content. Pass as a JSON object or a JSON string.

Responses

200 — Flow JSON uploaded

  • success (boolean)
  • validation_errors (array) — Empty array if valid; otherwise, contains validation error details from Meta

400 — Invalid JSON or flow is not in DRAFT status

401

404 — WhatsApp account not found