TriggerWhatsApp BusinessReal-timeUpdated June 2026

How do I trigger on WhatsApp delivery status changes?

Short answer: In TinyCommand, add the WhatsApp Business Message Status Update trigger to a workflow and publish. It listens through a WhatsApp Business webhook and fires your workflow within seconds of the event, with no polling and no code. Add a filter if you only want some events to start a run.

Trigger workflows on Message Status Update in WhatsApp Business — start free All 2 WhatsApp Business triggers

Trigger workflows on Message Status Update in WhatsApp Business — start free

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

Trigger

Message Status Update

When the matching event happens

new message status updateon message status updatewhen a whatsapp message status changes (sent, deliveredwhen message status updatewatch for message status update

What this trigger returns

for the curious

You don’t need to read this. TinyCommand auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "status": "delivered",
  "recipient": "15559876543",
  "message_id": "wamid.123"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
status	string	"delivered"
recipient	string	"15559876543"
message_id	string	"wamid.123"

Pairs with

Drop these actions after Message Status Update.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about Message Status Update.

How does the Message Status Update trigger work in WhatsApp Business?

Fires whenever a WhatsApp message status changes (sent, delivered, read, failed). Use to reconcile sends, retry failures, or stop a sequence once the recipient has read.

Is the Message Status Update trigger real-time?

Yes. Message Status Update uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in WhatsApp Business.

What data does Message Status Update return?

The full event payload from WhatsApp Business. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter Message Status Update so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need WhatsApp Business admin permissions to use Message Status Update?

For most WhatsApp Business accounts a standard user can authorize the trigger. Some WhatsApp Business plans require an admin to enable third-party webhooks. Check WhatsApp Business's docs if the trigger fails to register.