account_review_update Webhook

Field reference for WhatsApp account_review_update webhooks: WABA review decisions, payload shape, and Dualhook handling.

The account_review_update field reports Meta's review decision for a WhatsApp Business Account (WABA). It is useful for account readiness and onboarding state, especially when a WABA cannot yet use APIs.

What account_review_update Reports

This field reports the WABA review outcome through a single decision value.

DecisionMeaning
APPROVEDThe WABA passed review and can be used with APIs.
REJECTEDThe WABA did not meet policy requirements and cannot be used with APIs.
PENDINGReview is still pending; API use may be blocked.
DEFERREDMeta deferred the decision or needs more information.

When It Fires

Meta sends this webhook when a WABA is approved, rejected, pending, or deferred after review against WhatsApp policy guidelines.

Payload Shape

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WABA_ID>",
      "time": 1739321024,
      "changes": [
        {
          "field": "account_review_update",
          "value": {
            "decision": "APPROVED"
          }
        }
      ]
    }
  ]
}

Dualhook Handling

Dualhook subscribes to account_review_update as a management event. Dualhook uses it to keep account-readiness signals current, surface review outcomes in operational views, and forward the event to your configured endpoint.

This field never contains message bodies, contacts, or media. Dualhook stores only the operational event metadata and delivery status needed for monitoring and auditability.

Implementation Notes

  • Treat non-APPROVED decisions as account-readiness blockers until Meta changes the decision or the business remediates the issue.
  • Store the WABA ID and event timestamp for audit trails.
  • Do not assume PENDING and DEFERRED mean the same thing. Both block use, but DEFERRED usually indicates Meta needs more signal or more information.
  • Pair this field with account_alerts and account_update for a fuller account-health picture.

Related

  • Webhook Subscription FieldsReference list of all 22+ WhatsApp Business Platform webhook subscription fields, what each notifies you of, required permissions, payload size limits, retry policy, mTLS support, and IP allowlisting.
  • Webhook Events & NotificationsManagement webhook events: template status, quality updates, account alerts, and forwarding.
  • WhatsApp Business AccountsWhat a WABA is, how it relates to phone numbers, and how ownership works.
  • Maintain Account HealthOwnership hygiene, quality monitoring, opt-out governance, and incident playbook.
Browse more docsStart Free Trial