Twilio Event Streams for WhatsApp

Twilio Event Streams lets you subscribe to WhatsApp template update events and receive real-time notifications when a template's status or category changes.

This event notifies you when a WhatsApp content template is updated. The update can include changes to the template's status or category. Additional template-change events will be documented later.

The type field indicates which kind of template event you are receiving. Current values are category_update and status_update. The updated information—and its previous state—appears in the template object.

• category_update: Contains information about WhatsApp template category changes.
• status_update: Contains information about WhatsApp template status changes.

For a full description of each field in a template-update event, see Messaging template approval: updated.

• Subscription event type: com.twilio.messaging.template.approval.updated

Example event payload

1
{
2
    "specversion": "1.0",
3
    "type": "com.twilio.messaging.template.approval.updated",
4
    "source": "/v1/Templates/HXXXXXXXXXXXXXXXX",
5
    "id": "databridge_event_cf7521e314094255afcbed3440640c15",
6
    "dataschema": "https://events-schemas.twilio.com/Messaging.ApprovalUpdated/1",
7
    "datacontenttype": "application/json",
8
    "time": "2026-07-14T23:00:29.472Z",
9
    "data": {
10
      "channel": "whatsapp",
11
      "accountSid": "ACXXXXXXXXXXXXXXXX",
12
      "template": {
13
        "friendlyName": "owl_update",
14
        "previousValue": "pending",
15
        "externalTemplateName": "owl_update_hxxxxxxxxxxxxx",
16
        "language": "en",
17
        "currentValue": "approved",
18
        "sid": "HXXXXXXXXXXXXXXXX"
19
      },
20
      "dateUpdated": "2026-07-14T23:00:29.472790453Z",
21
      "type": "status_update"
22
    }
23
  }