WhatsApp Flow Webhook Examples

This document provides examples of WhatsApp Flow webhook payloads that your application may receive when subscribing to flow-related events.

Flow Status Change

When a WhatsApp Flow changes its status (e.g., from DRAFT to PUBLISHED), you will receive a webhook with the following payload structure:

{
  "eventType": "whatsapp.flow.status_change",
  "eventId": "evt_1234567890abcdef",
  "apiVersion": "v2",
  "createTime": "2025-09-11T07:24:52.000Z",
  "flowChanges": {
    "flowId": "1097420589034000",
    "wabaId": "123456789012345",
    "message": "Flow Webhook 3 changed status from DRAFT to PUBLISHED",
    "oldStatus": "DRAFT",
    "newStatus": "PUBLISHED"
  }
}

Payload Description

eventType: Always whatsapp.flow.status_change for flow status change events
flowChanges: Contains the flow status change details
- flowId: The unique ID of the Flow that changed status
- wabaId: WhatsApp Business Account ID associated with the flow
- message: Human-readable description of the status change
- oldStatus: The previous status of the flow
- newStatus: The current status of the flow

Common Flow Status Values

DRAFT
PUBLISHED
DEPRECATED
BLOCKED
THROTTLED