Search error codes 107 entries
Connecting a number Templates Sending messages Account, access and permissions Billing, quality and policy Other platform errors Connecting a number (Embedded Signup, coexistence, registration) Shown in Meta’s popup or on Connection / My Numbers while you connect, verify or re-register a number.
3441047 Not available for accounts using marketing messages Fix first, then retry What it means Coexistence can’t be used on the WhatsApp Business account you picked. Common cause That WhatsApp Business account has marketing messages turned on (for example Marketing Messages Lite). How to fix it Run Connection → I already use the WhatsApp Business app on this number again and, when the popup asks which WhatsApp Business account to use, choose Create a new WhatsApp Business account . Retrying with the same account gives the same error. Meta’s documentation ↗
3441045 Number not eligible for coexistence Retry later What it means Meta doesn’t yet allow this WhatsApp Business app number on the platform. Common cause Not enough activity on the WhatsApp Business app — typically a new or rarely used number. How to fix it Keep using the number in the WhatsApp Business app for a while (about a week of normal chats), then try again. Or connect a new number instead. Meta’s documentation ↗
3441049 2655094 Number already connected to the Business Platform Fix first, then retry What it means The app number is still linked to another platform or provider. Common cause A previous provider or tool still has the number connected. How to fix it In the WhatsApp Business app: Settings → Account → Business Platform → Disconnect . Wait 15 minutes, then connect again in MeAPI. Meta’s documentation ↗
3441030 Number already registered Fix first, then retry What it means This number is already registered and can’t be added again here. Common cause The number is registered on WhatsApp, the WhatsApp Business app or another API account. How to fix it Use coexistence if it is on the WhatsApp Business app, deregister it from the other API account, or use a different number. Meta’s documentation ↗
— Number registered to an existing WhatsApp account (no code) Fix first, then retry What it means Meta’s popup says the number is already in use on WhatsApp. Common cause The number is on WhatsApp Messenger, the WhatsApp Business app or another API account. How to fix it For a WhatsApp Business app number: run I already use the WhatsApp Business app on this number (coexistence). Otherwise delete the WhatsApp account on the phone (allow up to 3 minutes), then enter the number again — or use a new number. Meta’s documentation ↗
2655095 2655048 Number not registered with WhatsApp Business Fix first, then retry What it means Coexistence needs the number to be active on the WhatsApp Business app. Common cause The number isn’t on the WhatsApp Business app (or was typed differently). How to fix it Install the WhatsApp Business app on the number first, or choose Connect a new number . Type the number exactly as it is in the app. Meta’s documentation ↗
3441042 Not available in this number’s region Don’t retry What it means Coexistence isn’t offered for this country. Common cause Meta hasn’t enabled the feature for the number’s country. How to fix it Connect a number from a supported country, or use a new number without coexistence. Meta’s documentation ↗
3441041 Number not tied to the selected business Fix first, then retry What it means The number belongs to a different business portfolio than the one picked in the popup. Common cause Wrong business portfolio selected. How to fix it Pick the portfolio that owns the number. Or remove the old link: Meta Business Suite → Settings → Accounts → WhatsApp Accounts → Remove , and delete the number in WhatsApp Manager → Phone numbers . Meta’s documentation ↗
2655093 Already shared with another partner Fix first, then retry What it means The app number is connected to another provider; switching directly isn’t supported. Common cause Another provider is still connected. How to fix it Disconnect the current partner in the WhatsApp Business app (Settings → Account → Business Platform ), then connect to MeAPI. Meta’s documentation ↗
2655082 Number linked to a Facebook Page Fix first, then retry What it means The number is attached to a Facebook Page, which blocks onboarding. Common cause WhatsApp is linked on the Page. How to fix it Meta Business Suite → Settings → Accounts → Pages : remove the WhatsApp link, then try again. Meta’s documentation ↗
4563015 WhatsApp Business app out of date Fix first, then retry What it means The app on the phone is too old for coexistence. Common cause Old app version. How to fix it Update the WhatsApp Business app from the Play Store / App Store (2.24.17 or newer), then run the signup again. Meta’s documentation ↗
2388098 Limited WhatsApp Business accounts until verified Fix first, then retry What it means An unverified business can only have a few WhatsApp Business accounts. Common cause Business verification not done. How to fix it Pick an existing WhatsApp Business account in the popup, or verify your business in Meta Business Suite → Security Center . Meta’s documentation ↗
2494067 Maximum WhatsApp Business accounts reached Fix first, then retry What it means This business portfolio has as many WhatsApp Business accounts as Meta allows. Common cause Too many unused accounts. How to fix it Select an existing account in the popup, or delete an unused one: Meta Business Suite → Settings → Accounts → WhatsApp Accounts . Meta’s documentation ↗
1752089 Only one business account at a time Retry later What it means Another account creation is still running. Common cause Two signups started close together. How to fix it Wait a few minutes and run the signup once. Meta’s documentation ↗
1690114 Business creation limit reached Fix first, then retry What it means You can’t create another business portfolio now. Common cause Too many portfolios created by this Facebook account. How to fix it Choose your existing business portfolio in the popup instead of creating one. Meta’s documentation ↗
— Maximum phone numbers linked (no code) Fix first, then retry What it means The portfolio has reached its phone-number limit. Common cause Too many numbers across its WhatsApp Business accounts. How to fix it Delete an unused number in WhatsApp Manager → Phone numbers , or ask Meta support for more. Meta’s documentation ↗
What it means Meta couldn’t send or check the SMS / voice verification code. Common cause Temporary issue, or the number can’t receive SMS / calls. How to fix it Try again, or switch between SMS and voice call. A landline needs voice call ; IVR numbers don’t work. If it keeps happening, open a ticket with Meta from Business Support Home (business.facebook.com/business-support-home) and send MeAPI support the error text. Meta’s documentation ↗
What it means You asked for the verification code too often. Common cause Repeated requests in a short time. How to fix it Wait (a few hours), then run the signup again and pick the existing account and number to request a new code. Meta’s documentation ↗
What it means Ownership verification isn’t available for this number in this flow. Common cause See the error details — often the number must be registered and verified the normal way. How to fix it Run Connect a new number and verify by SMS or voice. Read the error details in the popup. Meta’s documentation ↗
— Too many guesses (no code) Retry later What it means Too many wrong verification codes. Common cause Wrong code typed several times. How to fix it Wait about 12 hours, then run the signup again and pick the existing account and number. Meta’s documentation ↗
What it means Meta is rate-limiting signup attempts. Common cause Many tries in a short time. How to fix it Stop for a while (an hour or more), then run the signup once, slowly. Meta’s documentation ↗
2655091 CAPTCHA not completed Fix first, then retry What it means The security check in the popup was skipped. Common cause CAPTCHA closed or failed. How to fix it Run the signup again and complete the CAPTCHA. Meta’s documentation ↗
What it means Meta can’t use this number. Common cause Typo, wrong country code, or a number Meta won’t accept. How to fix it Check the number and country code, or use a different number. Read the error details for the exact reason. Meta’s documentation ↗
2388012 Phone number already in your list Fix first, then retry What it means The number already exists on this WhatsApp Business account. Common cause It was added earlier. How to fix it Pick the existing number in the popup instead of adding it again. Meta’s documentation ↗
2494030 Business verification in progress Retry later What it means New WhatsApp Business accounts are blocked until verification finishes. Common cause A verification is running. How to fix it Wait for it: Meta Business Suite → Security Center → Business verification . Meta’s documentation ↗
2494143 Partner-led verification already started Fix first, then retry What it means Another partner is verifying this business. Common cause Verification started by someone else. How to fix it Finish with that partner, or apply for Meta Business verification yourself. Meta’s documentation ↗
2655049 2494028 Account shared with another partner Fix first, then retry What it means This WhatsApp Business account is shared with another provider. Common cause Shared earlier. How to fix it Unshare it from the other partner, or create a new WhatsApp Business account in the popup. Meta’s documentation ↗
What it means Meta couldn’t share the selected WhatsApp Business account with MeAPI. Common cause Account state or permissions. How to fix it Pick a different WhatsApp Business account or create a new one. If it keeps happening, open a ticket with Meta from Business Support Home (business.facebook.com/business-support-home) and send MeAPI support the error text. Meta’s documentation ↗
2494091 Solution partner not verified Don’t retry What it means The partner side isn’t business-verified. Common cause Partner setup. How to fix it Contact MeAPI support. Meta’s documentation ↗
What it means The account (or adding numbers to it) is restricted. Common cause A policy restriction on the account. How to fix it Pick a different account, or fix the issue in Business Support Home and appeal there. Meta’s documentation ↗
— Name verification in progress / no permission / unverified business (no code) Fix first, then retry What it means The popup couldn’t create the WhatsApp Business account. Common cause You aren’t an admin of the business, a name check is running, or the business can’t be verified. How to fix it Use a Facebook account with admin rights on the business, wait for the name check, or pick another business. If it keeps happening, open a ticket with Meta from Business Support Home (business.facebook.com/business-support-home) and send MeAPI support the error text. Meta’s documentation ↗
— Business portfolio creation errors (no code) Fix first, then retry What it means Meta couldn’t create a business portfolio. Common cause New Facebook account, too many businesses, flagged activity or an invalid business name. How to fix it Use an established Facebook account and your existing portfolio, with your real business name. Meta’s documentation ↗
What it means A name or link you typed in the popup isn’t accepted. Common cause Duplicate, invalid or too long (over 255 characters) name, or a bad link. How to fix it Use your real business name and a working https link. Meta’s documentation ↗
2388010 2388009 Verified name can’t be edited / invalid Fix first, then retry What it means The display name was refused. Common cause It breaks Meta’s display-name rules or is locked. How to fix it See Change your WhatsApp display name . Meta’s documentation ↗
What it means Meta couldn’t create or link an ad account during signup. Common cause Ad account limits, a disabled payment account or ads policy issues on the business. How to fix it Resolve it in Business Support Home (or make a payment / verify the business to raise ad-account limits), then run the signup again. Meta’s documentation ↗
What it means You aren’t a full admin of the Page, or became admin less than a week ago. Common cause Page roles. How to fix it Ask a Page admin to add you (or to run the signup), or wait a week. Meta’s documentation ↗
What it means Meta wants two-factor authentication or a security check first. Common cause New device or location, or 2FA required for business tools. How to fix it Turn on 2FA in Facebook Accounts Center → Password and security , complete any security check, then try again (after a new-device login, wait a while). Meta’s documentation ↗
What it means Meta couldn’t create a public test number. Common cause Restrictions or temporary unavailability. How to fix it Connect a real number instead, or try later. Meta’s documentation ↗
What it means Something failed on Meta’s side during signup. Common cause Temporary Meta issue, or an account or asset problem. How to fix it Wait a few minutes and run the signup once more. If it keeps happening, open a ticket with Meta from Business Support Home (business.facebook.com/business-support-home) and send MeAPI support the error text. Meta’s documentation ↗
What it means Meta only imports WhatsApp Business app contacts and history once, within 24 hours of connecting. Common cause The sync window passed or was used up. How to fix it To import again, disconnect the number and connect it again with coexistence. Meta’s documentation ↗
133005 Two-step verification PIN incorrect Fix first, then retry What it means The 6-digit PIN for the number is wrong. Common cause MeAPI has an old PIN, or a typo. How to fix it Reset the PIN in WhatsApp Manager → Phone numbers → Two-step verification , then use My Numbers → Verify 2FA to switch with the new PIN. Meta’s documentation ↗
What it means PIN entry is locked for a while. Common cause Wrong PINs, or tries too close together. How to fix it Wait for the time in the error details, then enter the right PIN once. Meta’s documentation ↗
133006 Number needs verification before registering Fix first, then retry What it means The number hasn’t been verified by SMS / voice yet. Common cause Signup didn’t finish the code step. How to fix it Run the signup again and verify the number. Meta’s documentation ↗
133010 Phone number not registered Fix first, then retry What it means The number isn’t registered on the Cloud API, so it can’t send. Common cause Registration never finished, or the number was deregistered. How to fix it On Connection , connect the number again (or My Numbers → Verify 2FA to switch ). Messages can’t send until it is registered. Meta’s documentation ↗
131045 Phone number registration error Fix first, then retry What it means The sending number isn’t properly registered. Common cause Registration incomplete. How to fix it Register the number again from Connection , then resend. Meta’s documentation ↗
133000 Previous deregistration failed Fix first, then retry What it means An earlier deregistration didn’t finish. Common cause Interrupted deregistration. How to fix it Deregister again, then register. Contact MeAPI support. Meta’s documentation ↗
133004 Server temporarily unavailable Retry later What it means Meta’s registration service is down. Common cause Meta outage. How to fix it Check metastatus.com and try later. Meta’s documentation ↗
133015 Number recently deleted Retry later What it means The number’s deletion hasn’t finished. Common cause Deleted moments ago. How to fix it Wait 5 minutes and try again. Meta’s documentation ↗
133016 Too many registration attempts Retry later What it means The number is temporarily blocked from (de)registering. Common cause Too many attempts. How to fix it Wait until it unblocks; don’t keep clicking Verify 2FA to switch . Meta’s documentation ↗
2494100 Account in maintenance mode Retry later What it means The number is briefly in maintenance. Common cause Meta maintenance. How to fix it Try again in a few minutes. Meta’s documentation ↗
2388103 Cannot migrate phone number Fix first, then retry What it means Moving this number between WhatsApp Business accounts isn’t possible. Common cause Several reasons: display name not approved, account not set up or not approved, number in another portfolio, or a general migration error (see the details). How to fix it Get the display name approved, or connect the number fresh. For a general error, try later. Meta’s documentation ↗
What it means The account can’t move to a different solution or owner. Common cause Old on-behalf-of setup or WABA sharing. How to fix it Contact MeAPI support. Meta’s documentation ↗
33 Business phone number deleted Fix first, then retry What it means The phone number no longer exists on Meta. Common cause Deleted in WhatsApp Manager. How to fix it Connect the number again on Connection . Meta’s documentation ↗
Templates When you submit, edit or send a template. Rejections themselves have reasons, not codes — see Rejection reasons .
132000 Number of parameters doesn’t match Fix first, then retry What it means The template has a different number of {{variables}} than you filled. Common cause A variable left empty, or the template was edited in WhatsApp Manager. How to fix it Fill every variable. In MeAPI, Templates → Sync from Meta , then check the campaign / reminder / step mapping. Meta’s documentation ↗
132001 Template doesn’t exist (in this language) or isn’t approved Fix first, then retry What it means Meta has no approved template with that name and language. Common cause Deleted, still in review, rejected, or a different language code (en vs en_US). How to fix it Templates → Sync from Meta , check the status is Approved , and pick the exact language.Meta’s documentation ↗
132005 Translated text too long Fix first, then retry What it means After filling variables, the text is over Meta’s length limit. Common cause Long variable values. How to fix it Shorten the values (names, links, addresses) or the template. Meta’s documentation ↗
132007 Template content breaks policy Fix first, then retry What it means Meta refuses the content. Common cause Content against the WhatsApp Business / Commerce policies. How to fix it Rewrite it — see Template approval tips . Meta’s documentation ↗
132012 Variable format wrong Fix first, then retry What it means A variable’s value doesn’t match the template (for example a header image, a currency or a date). Common cause Wrong type for a header or button parameter. How to fix it Check the header media and button variables match what the template expects. Meta’s documentation ↗
132015 Template paused (low quality) Retry later What it means Meta paused the template after poor feedback (blocks, reports, low reads). Common cause Quality rating fell to low. A first pause lasts 3 hours, a second 6 hours. How to fix it Stop campaigns that use it. Wait for the pause to end (or unpause it in WhatsApp Manager), improve the text and audience. MeAPI shows the status under Templates . Meta’s documentation ↗
132016 Template disabled Don’t retry What it means Paused for the third time, so Meta disabled it. Common cause Repeated low quality. How to fix it Create a new template with better content (or edit and resubmit). Review who you send it to. Meta’s documentation ↗
132018 Template validation error Fix first, then retry What it means Template parameters have problems. Common cause Wrong parameters for the template. How to fix it Fix the parameters and send with a correctly configured template. Meta’s documentation ↗
2388019 Template limit reached Fix first, then retry What it means The WhatsApp Business account has the maximum number of templates. Common cause Too many templates (Meta allows 250 per WhatsApp Business account). How to fix it Delete templates you no longer use under Templates . Meta’s documentation ↗
2388039 Template status can’t be changed Retry later What it means You can’t edit the template right now. Common cause It is in review, or you hit the daily edit limit. How to fix it Wait for approval or rejection before editing, or create a new template. Meta’s documentation ↗
2388040 Character limit exceeded Fix first, then retry What it means A field (header, body, footer, button) is too long. Common cause Over Meta’s limit. How to fix it Shorten the field named in the error. The MeAPI editor shows the counts. Meta’s documentation ↗
What it means Formatting not allowed in that part. Common cause For example new lines or emoji in a text header, or a variable where none is allowed. How to fix it Read the error details and fix that part. Meta’s documentation ↗
2388293 Too many variables for the length Fix first, then retry What it means Too many {{variables}} for the amount of text. Common cause Short text with many variables. How to fix it Add more fixed words or use fewer variables. Meta’s documentation ↗
2388299 Variable at the start or end Fix first, then retry What it means A template can’t begin or end with a variable. Common cause {{1}} as the first or last thing.How to fix it Put words before the first and after the last variable. Meta’s documentation ↗
131063 Marketing templates disabled for Cloud API Fix first, then retry What it means The account has turned off marketing messages through the Cloud API. Common cause A setting in WhatsApp Manager. How to fix it Turn marketing messages on again in WhatsApp Manager, or send utility templates. Meta’s documentation ↗
What it means Template analytics aren’t available, can’t be turned off, or aren’t on yet. Common cause Account setting. How to fix it Nothing to fix for sending. MeAPI’s own Templates → stats still work. Meta’s documentation ↗
Sending messages On a failed message in the inbox, a campaign’s failures, a reminder’s log or the API.
131026 Message undeliverable Don’t retry What it means WhatsApp couldn’t deliver to this number. Common cause The number isn’t on WhatsApp, hasn’t accepted WhatsApp’s latest terms, or uses an old WhatsApp version. Sometimes the customer blocked you. How to fix it Check the number (country code). Ask the customer to update WhatsApp. Don’t keep retrying — reminders try once more after 6 hours. Meta’s documentation ↗
131047 More than 24 hours since the customer last replied Fix first, then retry What it means The 24-hour window is closed, so free text, media and buttons can’t be sent. Common cause You replied after the window closed. How to fix it Send an approved template (inbox → Send template ). When the customer replies, the window opens again. Meta’s documentation ↗
131049 Not delivered to keep engagement healthy Retry later What it means Meta held back a marketing message to this person. Common cause Meta limits how many marketing messages one person gets from businesses. Not a problem with your account. How to fix it Don’t resend straight away — wait at least 24 hours. Send fewer, more relevant offers. MeAPI reminders retry once after 24 hours. Meta’s documentation ↗
131050 Customer stopped marketing messages Don’t retry What it means This person turned off marketing messages from you in WhatsApp. Common cause Their choice. How to fix it Don’t send them marketing templates. Utility and service messages still work. Meta’s documentation ↗
131051 Unsupported message type Don’t retry What it means This message type can’t be sent (or received) through the API. Common cause For incoming items: polls, view-once media and some history items. For outgoing: a type WhatsApp doesn’t support. How to fix it Send a supported type. In the inbox these show as grey “Unsupported message” lines — open WhatsApp on the phone to see them. Meta’s documentation ↗
131052 Couldn’t download the customer’s media Don’t retry What it means A photo or file the customer sent couldn’t be fetched. Common cause Media expired or failed on Meta’s side. How to fix it Ask the customer to send it again. Meta’s documentation ↗
131053 Media upload failed Fix first, then retry What it means Your file couldn’t be uploaded to WhatsApp. Common cause Unsupported type or too large. How to fix it Use JPG / PNG images up to 5 MB, MP4 video up to 16 MB, PDF documents up to 100 MB. Meta’s documentation ↗
131056 Too many messages to the same person Retry later What it means You sent this customer many messages in a short time. Common cause A loop or rapid sends to one number. How to fix it Wait a little; other customers aren’t affected. MeAPI slows down and retries automatically. Meta’s documentation ↗
130429 Throughput limit reached Retry later What it means Your number is sending faster than its per-second limit. Common cause A large campaign. How to fix it Nothing to do — MeAPI backs off and continues. Very large lists simply take longer. Meta’s documentation ↗
131048 Spam rate limit hit Retry later What it means Meta restricted how many messages this number can send. Common cause Many customers blocked or reported your messages. How to fix it Pause campaigns, check quality in My Numbers / WhatsApp Manager, send only to opted-in contacts and make messages wanted. Meta’s documentation ↗
131064 Limit due to template category violations Retry later What it means Meta limits sending because templates were in the wrong category. Common cause Marketing content submitted as utility. How to fix it Fix the templates’ categories. The limit lifts after Meta’s enforcement period. Meta’s documentation ↗
131042 Business eligibility payment issue Fix first, then retry What it means Meta can’t charge for the message, so it isn’t sent. Common cause Billing in Meta isn’t set up: no payment method or credit line attached to the WhatsApp Business account, credit line over its limit, time zone or currency not set, the account suspended or deleted, or an on-behalf-of request pending or declined. How to fix it In Meta Business Suite → Billing & payments (or WhatsApp Manager → Payment settings ), add a valid card and check the account’s currency and time zone. Then resend. MeAPI reminders retry up to 3 times, an hour apart. Meta’s documentation ↗
131021 Sender and recipient are the same Don’t retry What it means You tried to message your own business number. Common cause Testing with the business number. How to fix it Test with another phone. Meta’s documentation ↗
130403 Customer blocked the business Don’t retry What it means This customer has blocked you on WhatsApp. Common cause Their choice. How to fix it Don’t retry. They must unblock you. Meta’s documentation ↗
130472 Held back for a Meta experiment Don’t retry What it means Meta didn’t send this marketing message as part of an experiment. Common cause Meta’s marketing message experiment. How to fix it Nothing to fix; not charged. Meta’s documentation ↗
131037 555 number without an approved display name Fix first, then retry What it means A Meta-provided 555 number can’t send until its display name is approved. Common cause Name pending or rejected. How to fix it See Change your WhatsApp display name . Meta’s documentation ↗
131008 Required parameter missing Fix first, then retry What it means Something required was left out of the request. Common cause Empty field, or an API call missing a value. How to fix it Fill all required fields (API: check the request against the API docs ). Meta’s documentation ↗
131009 Parameter value invalid Fix first, then retry What it means A value isn’t allowed (for example a bad phone number or button). Common cause Wrong value. How to fix it Read the error details and correct that value. Meta’s documentation ↗
132068 132069 WhatsApp Flow blocked / throttled Fix first, then retry What it means The Flow can’t be sent (blocked), or only 10 messages with it per hour (throttled). Common cause Flow health issues — usually endpoint errors. How to fix it Fix the Flow (and its endpoint) under WhatsApp Flows . Meta’s documentation ↗
134011 WhatsApp Payments terms not accepted Fix first, then retry What it means Payments terms are pending. Common cause Terms not accepted. How to fix it Accept the terms through the link in the error. Meta’s documentation ↗
Account, access and permissions The connection’s access token or permissions — MeAPI shows these on Connection and in failed sends.
190 Access token expired Fix first, then retry What it means MeAPI’s access to your WhatsApp account has expired or was removed. Common cause You removed MeAPI in Meta Business Suite, changed your Facebook password, or the token expired. How to fix it Open Connection and connect the number again (same account). Nothing is lost. Meta’s documentation ↗
0 Couldn’t authenticate the app user Fix first, then retry What it means The access token was invalidated or access was blocked. Common cause Token expired, invalidated, or the user removed the app. How to fix it Reconnect on Connection . Meta’s documentation ↗
What it means MeAPI lacks a permission on your WhatsApp Business account (or code 200: no token sent). Common cause Permissions were unticked in the popup or removed later. How to fix it Reconnect on Connection and allow every permission Meta asks for. API users: send a valid key. Meta’s documentation ↗
100 Invalid parameter Fix first, then retry What it means A value or field name in the request isn’t valid. Common cause Typo, wrong phone number ID, or a value too long. How to fix it Read the error details. In MeAPI, re-check the template or message; API users check the request. Meta’s documentation ↗
4 App rate limit Retry later What it means Too many API calls from the app. Common cause Heavy traffic. How to fix it Wait and retry; MeAPI backs off automatically. Meta’s documentation ↗
80007 WhatsApp Business account rate limit Retry later What it means Too many calls for this WhatsApp Business account. Common cause Heavy traffic. How to fix it Wait and retry; MeAPI slows down automatically. Meta’s documentation ↗
Billing, quality and policy Problems with the account itself. Fix them in Meta Business Suite; MeAPI can’t override them.
368 Account restricted for a policy violation Don’t retry What it means Meta restricted or disabled your WhatsApp Business account. Common cause Messages or business against WhatsApp policies. How to fix it Read the notice in WhatsApp Manager / Business Support Home and request a review if you think it is wrong. Send only to opted-in customers. Meta’s documentation ↗
131031 Account locked or data couldn’t be verified Fix first, then retry What it means The account is restricted, or the request didn’t match the account (often a wrong two-step PIN). Common cause Policy restriction, or the PIN changed. How to fix it Check Business Support Home for a restriction. If not, re-enter the PIN in My Numbers → Verify 2FA to switch . Meta’s documentation ↗
130497 Can’t message users in this country Don’t retry What it means Your business category may not message this country. Common cause Meta’s country rules by business category. How to fix it Don’t send to that country. Meta’s documentation ↗
131057 Account in maintenance Retry later What it means Temporarily in maintenance, for example during a throughput upgrade. Common cause Meta maintenance. How to fix it Retry in a few minutes. Meta’s documentation ↗
Other platform errors General errors from Meta’s servers, and codes for Meta’s Marketing Messages API (MeAPI sends through the Cloud API).
1 Invalid request or server error Retry later What it means The request failed. Common cause A Meta issue or a malformed request. How to fix it Check metastatus.com, then retry. If it keeps happening, open a ticket with Meta from Business Support Home (business.facebook.com/business-support-home) and send MeAPI support the error text. Meta’s documentation ↗
2 131016 Service temporarily unavailable Retry later What it means Meta is down or overloaded. Common cause Meta outage. How to fix it Retry later. MeAPI campaigns retry temporary errors automatically. Meta’s documentation ↗
131000 Unknown error Safe to retry What it means The message failed for an unknown reason. Common cause Unspecified. How to fix it Retry once. If it keeps happening, open a ticket with Meta from Business Support Home (business.facebook.com/business-support-home) and send MeAPI support the error text. Meta’s documentation ↗
135000 Generic parameter error Fix first, then retry What it means Something in the request is wrong. Common cause Unknown parameter problem. How to fix it Check the message. If it keeps happening, open a ticket with Meta from Business Support Home (business.facebook.com/business-support-home) and send MeAPI support the error text. Meta’s documentation ↗
131055 134100 Only marketing messages supported (Marketing Messages API) Fix first, then retry What it means That API only accepts marketing templates. Common cause A utility or authentication template on the Marketing Messages API. How to fix it Use a marketing template there, or send through MeAPI normally. Meta’s documentation ↗
134101 Template still syncing (Marketing Messages API) Retry later What it means The template isn’t ready on that API yet. Common cause Syncing takes up to 10 minutes. How to fix it Wait 10 minutes and retry. Meta’s documentation ↗
134102 Template unavailable (Marketing Messages API) Don’t retry What it means The template couldn’t be used there. Common cause Ad sync failed or the account isn’t eligible. How to fix it Check eligibility, or send through the Cloud API. Meta’s documentation ↗
1752041 Duplicate onboarding request Don’t retry What it means The business was already invited to onboard. Common cause Repeated invitation. How to fix it Nothing to do. Meta’s documentation ↗
No error matches. Try just the number (for example 131026) or one word.
