Cloud API

Two-Step Verification

You are required to set up two-step verification for your phone number, as this provides an extra layer of security to the 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.

EndpointAuthentication

/PHONE_NUMBER_ID

Solution Partners must authenticate themselves with an access token with the whatsapp_business_management permission.

Parameters

NameDescription

pin

Required.

A 6-digit PIN you wish to use for two-step verification.

Example

Sample request:

curl -X  POST \
 'https://graph.facebook.com/v19.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.

Updating PIN

If you forget or misplace your PIN, you can update it by following these steps in WhatsApp Manager:

  1. Go to settings, log into your Facebook Business, and click the business you are using to manage your WABA (WhatsApp Business Account).
  2. In the settings screen, click WhatApp Accounts and find the WABA you want to update the PIN for. Click on the WABA and a panel with its respective info will come up on the right-side of the page.
  3. In the WABA info panel, click Settings.
  4. In the new tab, click WhatsApp Manager.
  5. In WhatsApp Manager, find your phone number and click Settings.
  6. Click Two-step verification.
  7. In the Two-step verification tab, click Change PIN.
  8. You will be prompted to enter a new PIN and confirm it. You have now successfully updated your PIN.

See Also