---
title: "Register a connected WhatsApp number on the Cloud API"
method: POST
path: "/v1/accounts/{accountId}/whatsapp/register"
tags: ["WhatsApp"]
---

# Register a connected WhatsApp number on the Cloud API

`POST /v1/accounts/{accountId}/whatsapp/register`

Re-runs Meta's Cloud API registration for a WhatsApp account that is already connected.
Use it when the number has its own two-step verification PIN: the connect flows register
with a default PIN, Meta rejects that with error 133005, and the number then fails every
send with the misleading '(#200) You do not have the necessary permission to send messages'
while the account still shows as connected. The PIN is used for this call only and is not stored.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `pin` string — The 6-digit two-step verification PIN set on the number. Omitting it applies Zernio's managed default registration PIN, the same one every Embedded Signup connect sets automatically.

## Response `200`

Number registered on the WhatsApp Cloud API

- object
  - `registered` boolean
  - `accountId` string
  - `phoneNumberId` string

## Other responses

- `400` — Invalid request
- `401` — Invalid or expired credentials
- `404` — WhatsApp account not found
- `422` — Meta rejected the registration (e.g. PIN mismatch), or the number cannot be registered through the API.

## Changes

- **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/accounts/:accountId/whatsapp/register/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/a0d8f21b5abe?raw)