Home
WhatsApp
Whatsapp Flows Api Flow Structure
Whatsapp Flows Api Flow Structure
Flow from WhatsApp API
Type: object
Properties: 10
Flow is a JSON Structure definition published by WhatsApp, describing 10 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
id
name
status
categories
validation_errors
json_version
data_api_version
endpoint_uri
preview
whatsapp_business_account
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/json-structure/whatsapp-flows-api-flow-structure.json",
"name": "Flow",
"description": "Flow from WhatsApp API",
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "wamid.abc123"
},
"name": {
"type": "string",
"example": "Example Business"
},
"status": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED",
"DEPRECATED",
"BLOCKED",
"THROTTLED"
],
"example": "DRAFT"
},
"categories": {
"type": "array",
"items": {
"type": "string",
"enum": [
"SIGN_UP",
"SIGN_IN",
"APPOINTMENT_BOOKING",
"LEAD_GENERATION",
"CONTACT_US",
"CUSTOMER_SUPPORT",
"SURVEY",
"OTHER"
]
}
},
"validation_errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/FlowValidationError"
}
},
"json_version": {
"type": "string",
"example": "example_value"
},
"data_api_version": {
"type": "string",
"example": "example_value"
},
"endpoint_uri": {
"type": "string",
"format": "uri",
"example": "example_value"
},
"preview": {
"type": "object",
"properties": {
"preview_url": {
"type": "string",
"format": "uri"
},
"expires_at": {
"type": "datetime"
},
"id": {
"type": "string"
}
}
},
"whatsapp_business_account": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/whatsapp-flows-api-flow-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms .
A second provider on the same verified email joins the account you already have.