---
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. Omit it only if the number has no PIN of its own.

## 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.

---

[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/e0cd92070858/schema)