WhaBuzzdocs
Event catalogue

Number display name

A display-name review finished.

A display-name review finished.

Event type: number.name. Fixture payloads are the WhaBuzz Demo tenant's real ids with a fictional customer number; id, tenant_id and created_at in envelopes are illustrative.

#Display-name review decision

What Meta POSTs to WhaBuzz (fixtures/meta/phone_number_name_update.json):

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "26059971920328384",
      "changes": [
        {
          "value": {
            "display_phone_number": "14692311132",
            "decision": "APPROVED",
            "requested_verified_name": "WhaBuzz Demo",
            "rejection_reason": null
          },
          "field": "phone_number_name_update"
        }
      ]
    }
  ]
}
json

What your endpoint receives, as the body of a signed POST. raw is abbreviated here; on the wire it is the full body above.

{
  "id": "evt_01JAB3K9X2S8C4M7Q1V5R6T0YZ",
  "type": "number.name",
  "api_version": "2026-10-16",
  "created_at": "2025-10-16T05:12:03.481Z",
  "tenant_id": "a578246e-b97f-48e6-ae42-939ec3ccf917",
  "waba_id": "26059971920328384",
  "phone_number_id": null,
  "display_phone_number": "14692311132",
  "wamid": null,
  "wa_id": null,
  "user_id": null,
  "dedupe_key": "phone_number_name_update:<sha256 of the canonical value>",
  "data": {
    "display_phone_number": "14692311132",
    "decision": "APPROVED",
    "requested_verified_name": "WhaBuzz Demo",
    "rejection_reason": null,
    "field": "phone_number_name_update"
  },
  "raw": {
    "…": "the complete Meta POST body, byte for byte, as shown above"
  },
  "raw_path": "entry[0].changes[0].value"
}
json

This page as Markdown: /events/number-name.md. All docs in one file: /llms-full.txt.