Skip to main content
GET
Get flow

Concepts

Returns a specific flow, including the full flow_json and the validation_errors array with whatever Meta flagged. With sync=true, the state is fetched straight from Meta before responding — slower, but up to date.
The flowId is obtained in the response of Create flow or List flows.

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"

Query Parameters

sync
boolean

When true, fetches the flow state straight from Meta before responding

Example:

true

Response

Operation completed successfully

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