---
title: "WhatsApp number declined event"
method: POST
path: "whatsapp.number.declined"
tags: ["Webhook Events"]
---

# WhatsApp number declined event

`POST whatsapp.number.declined` (webhook)

Fired when a regulated (Tier 3/4) number order is declined or fails
review. The number is never billed. `reason` carries the reviewer's
rejection reason when available.

## Payload

- object
  - `id` string
  - `event` 'whatsapp.number.declined'
  - `timestamp` string, date-time
  - `number` object
    - `id` string
    - `phoneNumber` string
    - `country` string
    - `profileId` string
  - `reason` string, nullable

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)