Skip to main content
PUT
Update flow

Concepts

Updates an existing flow. Every field is optional — only the ones you send change.
A PUBLISHED flow does not accept flow_json changes. To change the screens of an already published flow, create a new one and deprecate the old one with Deprecate flow.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

wabaId
string
required

WABA ID (obtained via List WABAs)

Example:

"428083093730937"

flowId
string
required

Flow ID (obtained via List flows)

Example:

"1122334455667788"

Body

application/json
name
string

Flow name

categories
enum<string>[]

Flow categories (Meta uses them during review)

Available options:
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY,
OTHER
flow_json
string

Screen definition in JSON, sent as a string

endpoint_uri
string

Your endpoint URL, required only for flows using data_exchange

Response

Flow updated

id
string

Flow ID

name
string

Flow name

categories
enum<string>[]

Flow categories (Meta uses them during review)

Available options:
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY,
OTHER
status
enum<string>

Publication status

Available options:
DRAFT,
PUBLISHED,
DEPRECATED,
BLOCKED,
THROTTLED
endpoint_uri
string | null

Your endpoint URL, required only for flows using data_exchange

flow_json
string

Screen definition in JSON, sent as a string

validation_errors
object[]

Validation issues returned by Meta