Skip to main content

How to use WABA and phone number webhook events

Summary

This guide explains the webhook events related to WhatsApp Business Accounts (WABA) and phone numbers in Wati. These events help you monitor account status changes, policy updates, phone number quality updates, and deletion events in real time. You can use these webhooks to automate notifications, trigger workflows, and keep your internal systems synchronized with Wati.

Note: For more information about Wati webhooks, refer to the Wati developer documentation.

Instructions

1. WABA status review update

This webhook is triggered when the review status of a WhatsApp Business Account changes.

  • Triggered when: The review status of a WhatsApp Business Account (WABA) changes

  • Event: wabaStatusReviewUpdate

  • Status: WABA review status updated

Sample webhook payload

{
  "eventType": "wabaStatusReviewUpdate",
  "accountReviewStatus": "APPROVED",
  "wabaId": "330039560200863"
}

WABA review status values

Status value

Description

APPROVED

The WhatsApp Business Account is approved and ready to use with APIs.

REJECTED

The WhatsApp Business Account was rejected due to policy violations and cannot be used with APIs.

PENDING

The review process is still pending and the WhatsApp Business Account cannot yet be used with APIs.

DEFERRED

The review decision has been deferred and the WhatsApp Business Account currently cannot be used with APIs.

Use cases

  • Monitor WhatsApp Business Account review status changes automatically

  • Notify admins when a WABA is approved or rejected

  • Trigger onboarding workflows after WABA approval

  • Pause API-related workflows when a WABA is pending or deferred

  • Keep internal systems synchronized with WABA review updates

2. WABA account deleted

This webhook is triggered when a WhatsApp Business Account is deleted.

  • Triggered when: A WhatsApp Business Account (WABA) is deleted

  • Event: accountDeleted

  • Status: WABA account deleted

Sample webhook payload

{
  "eventType": "accountDeleted",
  "wabaId": "message.WabaId"
}

Use cases

  • Detect when a WhatsApp Business Account is removed

  • Notify admins about deleted WABA accounts

  • Remove disconnected WABA accounts from internal systems

  • Trigger cleanup workflows after account deletion

  • Keep account records synchronized with Wati updates

3. WABA account content updated

This webhook is triggered when a WhatsApp Business Account receives account-related updates such as policy violations, bans, or restrictions.

  • Triggered when: A WhatsApp Business Account (WABA) receives an account-related update such as policy violations, bans, or restrictions

  • Event: accountUpdated

  • Status: WABA account updated

Sample webhook payload

{
  "eventType": "accountUpdated",
  "wabaId": "message.WabaId",
  "event": "message.Event",
  "violationInfo": {
    "violation_type": "message.ViolationType"
  },
  "banInfo": {
    "waba_ban_state": "message.WabaBanState",
    "waba_ban_date": "message.WabaBanDate"
  },
  "restriction_info": [
    {
      "restriction_type": "RESTRICTED_ADD_PHONE_NUMBER_ACTION",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    }
  ]
}

Restriction types

Restriction type

Description

RESTRICTED_ADD_PHONE_NUMBER_ACTION

Restricts adding new phone numbers to the WABA.

RESTRICTED_BIZ_INITIATED_MESSAGING

Restricts business-initiated messaging.

RESTRICTED_CUSTOMER_INITIATED_MESSAGING

Restricts customer-initiated messaging.

Use cases

  • Monitor policy violations on WhatsApp Business Accounts

  • Detect account bans or restrictions automatically

  • Notify admins about account health issues

  • Trigger workflows when messaging restrictions are applied

  • Keep compliance and monitoring systems synchronized with WABA updates

  • Track restriction expiration dates for operational planning

4. Phone number quality update event

This webhook is triggered when the messaging quality, throughput, or messaging limit of a WhatsApp phone number changes.

  • Triggered when: The messaging quality, throughput, or messaging limit of a WhatsApp phone number changes

  • Event: PhoneNumberQualityUpdatedEvent

  • Status: Phone number quality updated

Sample webhook payload

{
  "eventType": "PhoneNumberQualityUpdatedEvent",
  "phoneNumber": "12177593225",
  "event": "THROUGHPUT_UPGRADE",
  "currentLimit": "TIER_UNLIMITED",
  "oldLimit": "",
  "channelId": null,
  "channelPhoneNumber": "17735704742"
}

Messaging limit and throughput values

Value

Description

TIER_50

Messaging limit of 50.

TIER_250

Messaging limit of 250.

TIER_1K

Messaging limit of 1,000.

TIER_10K

Messaging limit of 10,000.

TIER_100K

Messaging limit of 100,000.

TIER_NOT_SET

The business phone number has not yet been used to send messages.

TIER_UNLIMITED

The business phone number has higher throughput and unlimited messaging capacity.

Use cases

  • Monitor messaging limit and throughput changes automatically

  • Detect phone number quality upgrades or downgrades

  • Notify admins when messaging capacity changes

  • Track messaging tier upgrades across WhatsApp numbers

  • Trigger operational workflows based on throughput changes

5. Phone number deleted

This webhook is triggered when a phone number is removed from a WhatsApp Business Account.

  • Triggered when: A phone number is removed from a WhatsApp Business Account (WABA)

  • Event: phoneNumberDeleted

  • Status: Phone number deleted

Sample webhook payload

{
  "eventType": "phoneNumberDeleted",
  "wabaId": "message.WabaId",
  "phoneNumber": "message.PhoneNumber"
}

Use cases

  • Detect when a phone number is removed from a WhatsApp Business Account

  • Notify admins about deleted WhatsApp numbers

  • Remove disconnected phone numbers from internal systems

  • Trigger cleanup workflows after phone number deletion

  • Keep account and channel records synchronized with Wati updates

Frequently Asked Questions (FAQs)

WABA webhook events

1. What are WABA and phone number webhook events in Wati used for?

WABA and phone number webhook events in Wati are used to monitor account status changes, policy updates, phone number quality updates, and deletion events in real time. These webhooks can help automate notifications, trigger workflows, and keep internal systems synchronized with Wati.

2. What does the wabaStatusReviewUpdate webhook event mean?

The wabaStatusReviewUpdate webhook event is triggered when the review status of a WhatsApp Business Account (WABA) changes.

3. What do the WABA review status values mean?

The WABA review status values have the following meanings:

  • APPROVED means the WhatsApp Business Account is approved and ready to use with APIs.

  • REJECTED means the WhatsApp Business Account was rejected due to policy violations and cannot be used with APIs.

  • PENDING means the review process is still pending and the WhatsApp Business Account cannot yet be used with APIs.

  • DEFERRED means the review decision has been deferred and the WhatsApp Business Account currently cannot be used with APIs.

4. What does the accountDeleted webhook event mean?

The accountDeleted webhook event is triggered when a WhatsApp Business Account (WABA) is deleted.

5. What does the accountUpdated webhook event mean?

The accountUpdated webhook event is triggered when a WhatsApp Business Account receives account-related updates such as policy violations, bans, or restrictions.

6. What restriction types can be included in the accountUpdated webhook?

The accountUpdated webhook can include the following restriction types:

  • RESTRICTED_ADD_PHONE_NUMBER_ACTION restricts adding new phone numbers to the WABA.

  • RESTRICTED_BIZ_INITIATED_MESSAGING restricts business-initiated messaging.

  • RESTRICTED_CUSTOMER_INITIATED_MESSAGING restricts customer-initiated messaging.

7. What does the PhoneNumberQualityUpdatedEvent webhook event mean?

The PhoneNumberQualityUpdatedEvent webhook event is triggered when the messaging quality, throughput, or messaging limit of a WhatsApp phone number changes.

8. What do the messaging limit values mean in the PhoneNumberQualityUpdatedEvent webhook?

The messaging limit values indicate the messaging capacity of a WhatsApp phone number:

  • TIER_50 means a messaging limit of 50.

  • TIER_250 means a messaging limit of 250.

  • TIER_1K means a messaging limit of 1,000.

  • TIER_10K means a messaging limit of 10,000.

  • TIER_100K means a messaging limit of 100,000.

  • TIER_NOT_SET means the business phone number has not yet been used to send messages.

  • TIER_UNLIMITED means the business phone number has higher throughput and unlimited messaging capacity.

9. What does the phoneNumberDeleted webhook event mean?

The phoneNumberDeleted webhook event is triggered when a phone number is removed from a WhatsApp Business Account (WABA).

Related Articles
How to send WhatsApp messages using Zapier webhooks and Wati
How to update the connected phone number and business portfolio
How to set up webhooks for WhatsApp Business Account (WABA) notifications
How to set up webhooks for multiple WhatsApp numbers in Wati
How to integrate & use Wati with n8n
Did this answer your question?