WhatsApp Flow Webhook Examples

​

What it is

​

Before you begin

• Create a public HTTPS endpoint in your application.
• Configure a YCloud webhook endpoint for the event types you need.
• Store the endpoint signing secret securely.
• Make event processing idempotent.

​

How it works

​

Request

​

Response

HTTP/1.1 200 OK

​

Flow Status Change

​

Request

{
  "type": "whatsapp.flow.status_change",
  "id": "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"
  }
}

​

Response

HTTP/1.1 200 OK

​

Explanation

• type: 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