---
title: "Start caller-ID verification for a customer-brought number"
method: POST
path: "/v1/phone-numbers/{id}/whatsapp/caller-id-verification"
tags: ["WhatsApp Calling"]
---

# Start caller-ID verification for a customer-brought number

`POST /v1/phone-numbers/{id}/whatsapp/caller-id-verification`

Customer-brought (BYO) WhatsApp numbers cannot present themselves as
caller ID on `tel:` call forwards until verified (carrier
anti-spoofing); until then forwarded calls show a Zernio number
(`callerIdMode: platform` on the calling config). This sends a
one-time code to the number by SMS or voice call. Re-POST to resend.
Zernio-purchased numbers never need this and get a 400.

## Path parameters

- `id` string, required

## Request body

- object
  - `method` 'sms' | 'call'

## Response `200`

Code sent (or the number was already verified)

- object
  - `verified` boolean
  - `codeSent` boolean
  - `method` 'sms' | 'call'

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Number not found
- `429` — Too many verification attempts for this number; wait before retrying

## Changes

- **2026-09-25** `2c04683ce694` — 4 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - added the optional property `details/stage` to the response with the `400` status
  - added the optional property `details/unconfirmedWrite` to the response with the `400` status
- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `400` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `400` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/phone-numbers/:id/whatsapp/caller-id-verification/post.md)

---

[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/b2325332041a?raw)