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

# WhatsApp number action required event

`POST whatsapp.number.action_required` (webhook)

Fired when the regulator asks for more information on an already-placed
regulated number order. The number stays pending (nothing was rejected);
the customer can provide the missing information from the dashboard, or
via the remediation endpoint. `reason` carries the regulator's request
verbatim when available. `requirements` lists every requirement on the
order with the reviewer's current verdict; the `declined` ones are what to
fix, keyed by the same `requirementId` the remediation endpoint uses.
Verdicts only change when a reviewer acts, so they describe the review at
`reviewedAt`, the time of the reviewer's last comment.

## Payload

- object
  - `id` string
  - `event` 'whatsapp.number.action_required'
  - `timestamp` string, date-time — UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
  - `reason` string
  - `requirements` object[] — Every requirement on the order with the reviewer's current verdict. Omitted when the order's requirements could not be read.
    - `requirementId` string — Same id as fields[].requirementId on the remediation endpoint.
    - `label` string
    - `status` 'approved' | 'pending' | 'declined'
  - `reviewedAt` string, date-time — When the reviewer last commented on the order. Omitted when there is no reviewer comment.
  - `number` object
    - `id` string
    - `phoneNumber` string
    - `country` string
    - `profileId` string

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/fdaf9a9fb1a7?raw)