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

# WhatsApp number suspended event

`POST whatsapp.number.suspended` (webhook)

Fired when an active number is suspended (e.g. a failed payment). The
number stops working until the issue is resolved, after which a
`whatsapp.number.reactivated` event is sent. `reason` carries the cause
(e.g. `payment_failed`, `subscription_ended`).

## Payload

- object
  - `id` string
  - `event` 'whatsapp.number.suspended'
  - `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/revisions/1e9a379eafca/schema)