Two-Step Verification

/v1/settings/account/two-step

Use two-step verification to add an extra layer of security to the WhatsApp Business API Client. When you have two-step verification enabled, any attempt to register your phone number on WhatsApp must be accompanied by the six-digit PIN that you create using this feature. Two-step verification can be enabled and disabled using the /v1/settings/account/two-step endpoint.

Before You Start

You must use the admin account to access the two-step verification settings.

Enabling

To enable two-step verification, use the /v1/settings/account/two-step endpoint with the pin parameter.

Example

POST /v1/settings/account/two-step
{
    "pin": "your-6-digit-pin"
}

A successful request returns the HTTP Status Code 200 OK and either null or {}. If you encounter any errors, see Error and Status Messages.

Disabling

To disable two-step verification, make a DELETE call to the /v1/settings/account/two-step endpoint.

Example

DELETE /v1/settings/account/two-step

A successful request returns the HTTP Status Code 200 OK and either null or {}. If you encounter any errors, see Error and Status Messages.

Resetting your PIN

If you forget or misplace your PIN, you can disable two-step verification, and then enable it again with a new PIN.

Using the Two-Step Verification PIN in Registration

If you are trying to re-register while the account has two-step verification enabled, include the pin parameter in the registration request. For more details on registration with two-step verification enabled, see the Registration documentation.