When your WhatsApp API stops working or Meta Business Manager shows a restriction, the first step is to identify the affected account. A business portfolio restriction, a disabled WhatsApp Business Account, and a failed API request require different investigations.
For a restricted WhatsApp Business Account, check Meta Business Support Home, read the issue attached to the account, and use Request review if available. For Business Manager restrictions, follow the account-specific actions Meta displays.
This guide explains how to organize your investigation and prepare an evidence-based review request. Reinstatement depends on Meta’s decision and cannot be guaranteed.
Identify the Problem Before Making Changes
“WhatsApp API disabled” is often used to describe several different problems. Record the exact message instead of relying on a general description.
| What you see | What to check first |
|---|---|
| Business portfolio restricted | The portfolio’s issue details and required actions |
| WhatsApp Business Account disabled | The account’s policy notice and review eligibility |
| One phone number affected | The number’s status and related account notices |
| A template rejected or paused | Feedback on that specific template |
| Message requests returning errors | Error codes, permissions, credentials, and configuration |
For example, an expired access token can require technical troubleshooting. An explicit policy restriction requires attention to the policy notice. Do not assume that every delivery failure means your business has been banned.
Create an Account Restriction Record
Before editing settings or contacting support, collect the information needed to describe the problem clearly:
- Business portfolio name and ID
- WhatsApp Business Account ID
- Affected business phone number
- Exact restriction wording
- Date and time the problem started
- Relevant API error messages
- Screenshots and existing support case numbers
Keep this record private. Redact customer information, access tokens, and other confidential details before sharing screenshots. A clear timeline helps you distinguish the original issue from changes made during troubleshooting.
How to Check a Business Manager Restriction
Open the Correct Business Portfolio
Visit Meta Business Support Home using an administrator account. Select the affected business and inspect the issue details. Meta states that an administrator must request a review of a restricted account.
If your organization manages multiple portfolios, compare the displayed business ID with your records before taking action.
Follow the Displayed Requirements
Read the instructions attached to the restriction. Complete any requested tasks using accurate information through Meta’s official interface. If documents are requested, check that the information describes the actual business consistently. Do not submit altered documents or claim ownership you cannot establish.
Request a Review if Eligible
Meta provides a review route for eligible restricted advertising accounts through Business Support Home. The available actions depend on the affected account and restriction. Your explanation should connect three things: the notice you received, the investigation you performed, and the evidence supporting reconsideration.
How to Investigate a Disabled WhatsApp API Account
Review the Policy Notice
Open the affected WhatsApp Business Account in Business Support Home and read the stated issue. Meta’s WhatsApp restriction guidance directs businesses to select the restricted account and choose Request review when available.
Save the notice before making changes. A specific policy reference is more useful than a generic assumption about why the account was disabled.
Audit Your Messaging Workflow
As a practical investigation, review the campaigns and automations active before the restriction. Ask:
- Where did the recipient list come from?
- What messages did recipients expect?
- Did the campaign match that expectation?
- Were requests to stop messaging processed?
- Did an automation send duplicate or unintended messages?
- Did recent integration changes affect delivery?
If a workflow appears to be sending unwanted messages, pause it while investigating. WhatsApp’s messaging guidelines explain that enforcement can use account information and user-reported messages. Feedback should therefore be treated as a useful signal when reviewing your activity.
Check Product and Service Eligibility
Review the current WhatsApp Business Messaging Policy for your business category. Some products and services are restricted, while certain regulated activities have specific conditions and limited exceptions. Check the rules that apply to your exact use case.
Separate Technical Errors From Enforcement
If no restriction appears, inspect the API response and configuration before preparing an appeal. As a troubleshooting checklist, review credentials, permissions, phone number identifiers, template status, and recent integration changes. If you use a messaging provider, ask it to interpret the relevant error logs. Send only the information necessary for diagnosis through an appropriate support channel.
What to Include in a WhatsApp Account Appeal
A useful review request should be specific, factual, and easy to assess. Include:
- The affected business and account identifiers.
- The exact reason shown in the notice.
- Your legitimate messaging purpose.
- Relevant investigation findings.
- Corrective actions actually completed.
- Evidence available to support the explanation.
Avoid unsupported statements such as “our account has never violated any policy” if you have not reviewed the activity.
Sample WhatsApp API Review Request
Replace every bracketed field with accurate information.
Hello Meta Support,
Please review the restriction affecting [business name], WhatsApp Business Account ID [WABA ID].
On [date], our account displayed the following notice: [exact notice].
We use WhatsApp for [specific messaging purpose]. We investigated [relevant campaign, integration, or workflow] and found [brief factual findings].
We completed [actual corrective actions, if applicable]. Supporting information includes [relevant records or screenshots].
We believe the restriction should be reconsidered because [evidence-based explanation].
Please let us know whether further information is required.
Thank you.
This template helps organize the facts. Its wording does not guarantee a different enforcement outcome.
What if You Cannot Request a Review?
Check that you have selected the correct business asset and are using the appropriate administrator account. Read the notice for unfinished tasks, review eligibility, or decision status. WhatsApp’s platform enforcement documentation describes appeal and acknowledgment processes, but available options depend on the issue.
If an official support option is available, explain that the review control is missing and attach a screenshot. Ask what action remains available for the specific account.
After Access Is Restored
Before restarting messaging, verify that the suspected cause has been addressed. Test the relevant workflow with authorized test recipients, confirm that stop requests are handled, and check that integrations send the intended content.
Maintain a simple change log covering campaign launches, automation updates, and administrator changes. This gives your team a useful reference if another issue occurs.
Frequently Asked Questions
Can business verification prevent a WhatsApp API ban?
Business verification does not replace policy compliance. WhatsApp Business Platform users remain subject to its terms and Business Messaging Policy.
How long does account recovery take?
Refer to the timing and status shown in your account or support case. Do not rely on a guaranteed recovery deadline from a third party.
Can a messaging provider remove the restriction?
A provider can help investigate configuration, interpret errors, and explain its support options. Do not assume that using a provider guarantees reinstatement.
Should I replace the account or phone number?
Investigate the original issue first. Replacing an asset does not explain the restriction or correct the underlying messaging practice.
Is the WhatsApp Business app review process different?
Yes. WhatsApp describes an in-app review process for banned Business app accounts. API account restrictions should be investigated through the relevant Meta business tools.
Official Documentation
- Meta Business Support Home
- Troubleshoot a Restricted WhatsApp Business Account
- WhatsApp Business Platform Policy Enforcement
- WhatsApp Business Messaging Policy
- WhatsApp Business Terms
Editorial note: This article is based on official documentation checked on October 21, 2026. Interfaces and review options may vary. Follow the instructions displayed for your own account.