Two-Step Verification

Updated: Jun 28, 2026

Copy for LLM

Set up two-step verification for your phone number to require a 6-digit PIN when registering the phone number. Use the WhatsApp Business Phone Number API to set it up with the parameters below. There is no endpoint to disable two-step verification.

Endpoint	Authentication
`/PHONE_NUMBER_ID` (See Get Phone Number ID)	Solution Partners must authenticate themselves with an access token with the `whatsapp_business_management` and `whatsapp_business_messaging` permissions.

Parameters

Name	Description
`pin`	Required. A 6-digit PIN you wish to use for two-step verification.

Example

Sample request:

curl -X  POST \
 'https://graph.facebook.com/v26.0/FROM_PHONE_NUMBER_ID' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{"pin" : "6_DIGIT_PIN"}'

Sample response:

{
  "success": true
}

All API calls require authentication with access tokens.

Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.

Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.

Reset your PIN

Note: The 6-digit two-step verification PIN is being deprecated for eligible Cloud API phone numbers, and eligibility rolls out gradually — see the 2FA PIN section of Account model evolution. Once a phone number is eligible, the Two-step verification tab no longer appears in WhatsApp Manager and there is no PIN to change there. If the tab is still present, the phone number is not yet eligible; follow the steps below.

Resetting your PIN is the non-API alternative to the API setup above. If you forget or misplace your PIN, update your PIN in WhatsApp Manager by following these steps:

Go to settings⁠ and log in to your Facebook Business. Click the business you use to manage your Messaging account.
In the settings screen, click Messaging Accounts. Find the Messaging account you want to update. Click the Messaging account. A panel with its info displays.
In the Messaging account info panel, click Settings.
In the new tab, click WhatsApp Manager.
In WhatsApp Manager, find your phone number and click Settings.
Click Two-step verification.
In the Two-step verification tab, click Change PIN.
Enter a new PIN and confirm it to complete the update.