Business account locked

This page describes how to solve the "Business account has been locked" error.

For various reasons, such as a WhatsApp Business Account (WABA) being temporarily restricted and later reinstated, a Business Account locked error may still occur when sending messages.

"error": {
        "message": "(#131031) Business Account locked",
        "type": "OAuthException",
        "code": 131031,
        "error_data": {
            "messaging_product": "whatsapp",
            "details": "Business account has been locked."
        },
        "error_subcode": ...,
        "fbtrace_id": "x"
    }
}

How to solve the issue

To resolve the issue, disable two-step verification (2FA) on the affected phone number, re-register the number and then enable 2FA again after registration is completed.

1

Disable 2FA

Disable two-step verification (2FA) on the affected phone number in WhatsApp Manager.

2

Re-register the number

Re-register the number by completing the Embedded Signup flow and selecting the existing WABA and the same phone number. Ensure the existing WABA and phone number are selected instead of creating a new WABA or registering a new number.

3

Re-enable 2FA

Re-enable 2FA after the number has been re-registered in WhatsApp Manager.

Finally, perform a health check on the phone number to confirm it is in a connected status and that no restrictions are reported.