Phone Number Operations
resource: phone-number — register, verify, and manage business numbers
list
Lists phone numbers registered to a WhatsApp Business Account.
| Field | Required | Description |
|---|---|---|
businessAccountId | ✓ Yes | WABA ID. |
get
Returns details for a single phone number.
No fields beyond the shared credential pair.
register
Registers a phone number for Cloud API use with a 6-digit PIN.
| Field | Required | Description |
|---|---|---|
pin | ✓ Yes | Two-step verification PIN to set/confirm during registration. |
deregister
Deregisters a phone number from Cloud API use.
No fields beyond the shared credential pair.
update-display-name
Requests a change to the number's public display name (subject to Meta review).
| Field | Required | Description |
|---|---|---|
displayName | ✓ Yes | New display name to request. |
request-verification
Requests an SMS or voice verification code for a new number.
| Field | Required | Description |
|---|---|---|
codeMethod | ✓ Yes | SMS or VOICE. |
language | No | Language/locale for the verification message. |
verify-code
Submits the verification code received via SMS/voice.
| Field | Required | Description |
|---|---|---|
code | ✓ Yes | Verification code. |
Registration flow: a new number typically goes
request-verification → verify-code → register
(with a PIN) before it can send/receive via Cloud API. Use deregister to release a number,
e.g. before migrating it to the WhatsApp Business App.