Skip to main content

Two-Step Verification | Developer Documentation

Two-Step Verification

Updated: Nov 5, 2025
Set up two-step verification for your phone number to add an extra layer of security to your business accounts. To set it up, make a POST call to /PHONE_NUMBER_ID and attach the parameters below. There is no endpoint to disable two-step verification.
Endpoint Authentication
/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/v25.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
If you forget or misplace your PIN, you can update it by following these steps in WhatsApp Manager:
    Go to settings⁠ and log into your Facebook Business. Click the business you use to manage your WABA (WhatsApp Business Account).In the settings screen, click WhatsApp Accounts. Find the WABA you want to update. Click the WABA. A panel with its info displays.In the WABA 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.
    
    
            
    
        
    
    
    
        
    
            
    
                
                
    
                    
                    
                
    
            
    
            
            
    
                                            
    
        
    
    
    

    

    
    
    

    
            
    
            
    

    
    
        
    
            
            
        
    
            
    

    
    
        
    
                    
    

        
    No comments to display
    

            
    

    

    

                
    
        
    
                
    
        
    
    
    

    
    

    
    
    
        
    
             Back to top