{"id":18283,"date":"2026-11-18T23:54:43","date_gmt":"2026-11-18T18:24:43","guid":{"rendered":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/"},"modified":"2026-11-19T00:56:43","modified_gmt":"2026-11-18T19:26:43","slug":"whatsapp-api-error-codes-list","status":"publish","type":"post","link":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/","title":{"rendered":"WhatsApp API error codes: full list with meaning and fix"},"content":{"rendered":"<p>This page lists every WhatsApp <a href=\"\/help\/fast2sms-api-error-codes\/\">API error code<\/a> that Meta publishes for the WhatsApp Cloud API, with a one-line meaning and what to do about it. It also shows where you find the error code for a failed message in your Fast2SMS panel, so you can match the code to the fix in a minute.<\/p>\n<p>Codes are grouped the same way Meta groups them: authorization, integrity, templates, phone numbers, throttling and others. The list follows Meta&#8217;s error code page at the time of writing. Meta adds and retires codes, so always read the details text that comes with the error too.<\/p>\n<aside class=\"f2s-cta\" aria-label=\"Get started with Fast2SMS\"><div class=\"f2s-cta__copy\"><strong class=\"f2s-cta__title\">Send WhatsApp messages on the official API<\/strong><p>Connect your number, get templates approved and see every delivery result in one report.<\/p><\/div><div class=\"f2s-cta__actions\"><a class=\"f2s-cta__btn f2s-cta__btn--primary\" href=\"https:\/\/www.fast2sms.com\/\"><span>Sign up free<\/span> <span class=\"f2sh-btn__arrow\" aria-hidden=\"true\">&rarr;<\/span><\/a><a class=\"f2s-cta__btn f2s-cta__btn--ghost\" href=\"https:\/\/www.fast2sms.com\/meet\/\" target=\"_blank\" rel=\"noopener\">Book a free meeting<\/a><\/div><\/aside>\n<h2>How WhatsApp error codes work<\/h2>\n<p>When a WhatsApp message or request fails, Meta returns an error with a few parts:<\/p>\n<ul>\n<li><strong>Code<\/strong>: a number such as 131026 or 2388040. This is what you look up below.<\/li>\n<li><strong>Title or message<\/strong>: a short name, for example &#8220;(#130429) Rate limit hit&#8221;.<\/li>\n<li><strong>Details<\/strong>: a longer reason in plain words. This is often the most useful part, because one code can have several causes.<\/li>\n<li><strong>fbtrace_id<\/strong>: a reference you can quote if you ever raise a ticket with Meta.<\/li>\n<\/ul>\n<p>Some errors come back at once, when the request is made. Others come later, in the delivery status of the message. Meta says titles and sub-codes are being phased out, so match on the code and the details, not on the title.<\/p>\n<h2>Where to find the error code in Fast2SMS<\/h2>\n<ol class=\"f2s-steps\">\n<li>\n<h3>Filter the WhatsApp report to failed messages<\/h3>\n<p>Click <strong>Delivery Report<\/strong> in the WhatsApp sidebar. You land on <strong>WhatsApp Reports<\/strong>. Pick a date range, click the filter button, choose <strong>Delivery Status<\/strong> and select <strong>Failed<\/strong>. The list now shows only campaigns with failed messages.<\/p>\n<figure class=\"f2s-shot\"><img src=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-failed-filter-hd-scaled.webp\" width=\"1440\" height=\"900\" loading=\"lazy\" decoding=\"async\" alt=\"WhatsApp Reports page filtered to Last 30 days and Failed, showing 19 failed messages and a campaign list\"><figcaption>WhatsApp Reports with the Failed filter on.<\/figcaption><\/figure>\n<\/li>\n<li>\n<h3>Open the campaign and read the Description column<\/h3>\n<p>Click the message text of a campaign to open <strong>Delivery Details<\/strong>. In the <strong>Receivers<\/strong> table, the <strong>Description<\/strong> column shows why each number failed. For most Meta errors it shows Meta&#8217;s reason followed by the code, in the form &#8220;reason (Error: code)&#8221;. <a href=\"\/help\/whatsapp-error-131026-message-undeliverable\/\">Error 131026<\/a> shows as &#8220;Message Undeliverable (Error: 131026)&#8221;.<\/p>\n<figure class=\"f2s-shot\"><img src=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-detail-failed-hd-1-scaled.webp\" width=\"1440\" height=\"900\" loading=\"lazy\" decoding=\"async\" alt=\"Delivery Details pop-up with a status donut, template preview and a Receivers table with Status and Description columns for failed numbers\"><figcaption>The Description column holds the failure reason for each number.<\/figcaption><\/figure>\n<\/li>\n<li>\n<h3>For template errors, read the message on screen<\/h3>\n<p>Errors in the template creation group (codes starting with 2388) appear when you click <strong>Submit Template<\/strong> in <strong>WhatsApp Manager<\/strong>. The pop-up message starts with &#8220;Failed to submit template.&#8221; followed by Meta&#8217;s reason. Fix the field it names and submit again.<\/p>\n<figure class=\"f2s-shot\"><img src=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-template-create-filled-hd-1-scaled.webp\" width=\"1440\" height=\"900\" loading=\"lazy\" decoding=\"async\" alt=\"Create WhatsApp Template form with template name, Body with two variables, sample boxes, footer and the Submit Template button\"><figcaption>Template errors show when you submit this form.<\/figcaption><\/figure>\n<\/li>\n<\/ol>\n<div class=\"f2s-note\">You are not charged for failed WhatsApp messages. Every failed message is refunded to your wallet automatically, whatever the error code. If you turn on <strong>Retry Failed<\/strong> for a number in WhatsApp Manager, messages that failed with 131026 or 131049 are tried again the next morning.<\/div>\n<p>If you send through the API, the delivery report for a request ID (and the &#8220;On Failed&#8221; webhook event) carries the same error details.<\/p>\n<h2>Authorization errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>0<\/td>\n<td>The access token could not be authenticated (expired, invalidated or access removed)<\/td>\n<td>Get a new access token<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>The app lacks a capability or permission the endpoint needs<\/td>\n<td>Check the token&#8217;s permissions and add the missing one<\/td>\n<\/tr>\n<tr>\n<td>10<\/td>\n<td>Permission not granted or removed<\/td>\n<td>Check token permissions and account eligibility<\/td>\n<\/tr>\n<tr>\n<td>190<\/td>\n<td>The access token has expired<\/td>\n<td>Get a new access token<\/td>\n<\/tr>\n<tr>\n<td>200<\/td>\n<td>No access token was sent with the request<\/td>\n<td>Send a valid access token<\/td>\n<\/tr>\n<tr>\n<td>200-299<\/td>\n<td>A permission in this range is missing or removed<\/td>\n<td>Check the token&#8217;s permissions<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Integrity errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>368<\/td>\n<td>The WhatsApp Business Account is restricted or disabled for a policy violation<\/td>\n<td>Review the violation and request a review with Meta<\/td>\n<\/tr>\n<tr>\n<td>130497<\/td>\n<td>The account cannot message users in certain countries<\/td>\n<td>Check which countries your business category may message<\/td>\n<\/tr>\n<tr>\n<td>131031<\/td>\n<td>Account locked, or data in the request (such as the two-step PIN) did not match the account<\/td>\n<td>Check policy enforcement and confirm the PIN<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Template creation errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2388039<\/td>\n<td>The template&#8217;s status cannot change right now (for example, it is in review)<\/td>\n<td>Wait for approval or rejection, then edit<\/td>\n<\/tr>\n<tr>\n<td>2388040<\/td>\n<td>A field is longer than its character limit<\/td>\n<td>Shorten the field named in the details<\/td>\n<\/tr>\n<tr>\n<td>2388047<\/td>\n<td>Header formatting is invalid<\/td>\n<td>Fix the header as the details say<\/td>\n<\/tr>\n<tr>\n<td>2388072<\/td>\n<td>Body formatting is invalid<\/td>\n<td>Fix the body as the details say<\/td>\n<\/tr>\n<tr>\n<td>2388073<\/td>\n<td>Footer formatting is invalid<\/td>\n<td>Fix the footer as the details say<\/td>\n<\/tr>\n<tr>\n<td>2388293<\/td>\n<td>Too many variables for the length of the message<\/td>\n<td>Add more fixed words or use fewer variables<\/td>\n<\/tr>\n<tr>\n<td>2388299<\/td>\n<td>A variable is at the very start or end of the template<\/td>\n<td>Put words before the first and after the last variable<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Send template errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2388019<\/td>\n<td>The account has reached its maximum number of templates<\/td>\n<td>Delete templates you no longer use<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Phone number migration errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2388012<\/td>\n<td>This phone number is already in the account<\/td>\n<td>Use the existing entry or a different number<\/td>\n<\/tr>\n<tr>\n<td>2388091, 2388093<\/td>\n<td>The number is not being migrated, so it cannot get a migration code<\/td>\n<td>Register and verify the number the normal way<\/td>\n<\/tr>\n<tr>\n<td>2388103<\/td>\n<td>The number cannot be migrated (several possible reasons, such as no approved <a href=\"\/help\/whatsapp-display-name-rules-rejected\/\">display name<\/a>)<\/td>\n<td>Read the details; fix the named cause or register normally<\/td>\n<\/tr>\n<tr>\n<td>2494100<\/td>\n<td>The business phone number is in maintenance mode<\/td>\n<td>Try again after a few minutes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Template insights errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>200005<\/td>\n<td>Template insights are not available for this account yet<\/td>\n<td>Nothing to do for now<\/td>\n<\/tr>\n<tr>\n<td>200006<\/td>\n<td>Template insights cannot be turned off once on<\/td>\n<td>Not needed<\/td>\n<\/tr>\n<tr>\n<td>200007<\/td>\n<td>Template insights are not turned on for this account<\/td>\n<td>Turn on template analytics in WhatsApp Manager<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>WhatsApp Business Account errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2593079<\/td>\n<td>The account is already marked for migration to a different partner<\/td>\n<td>Contact support (the old OBO model is retired)<\/td>\n<\/tr>\n<tr>\n<td>2593085<\/td>\n<td>The account is not valid for an OBO ownership move<\/td>\n<td>Contact support (the old OBO model is retired)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Synchronization errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>2593107<\/td>\n<td>The contacts or chat history sync was already used for this number<\/td>\n<td>Offboard and onboard the number again<\/td>\n<\/tr>\n<tr>\n<td>2593108<\/td>\n<td>Sync was asked for more than 24 hours after onboarding<\/td>\n<td>Offboard and onboard the number again<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<aside class=\"f2s-cta\" aria-label=\"Get started with Fast2SMS\"><div class=\"f2s-cta__copy\"><strong class=\"f2s-cta__title\">Check why a WhatsApp message failed<\/strong><p>Open the WhatsApp delivery report in your panel and see the reason for every number.<\/p><\/div><div class=\"f2s-cta__actions\"><a class=\"f2s-cta__btn f2s-cta__btn--primary\" href=\"https:\/\/www.fast2sms.com\/\"><span>Sign up free<\/span> <span class=\"f2sh-btn__arrow\" aria-hidden=\"true\">&rarr;<\/span><\/a><a class=\"f2s-cta__btn f2s-cta__btn--ghost\" href=\"https:\/\/www.fast2sms.com\/meet\/\" target=\"_blank\" rel=\"noopener\">Book a free meeting<\/a><\/div><\/aside>\n<h2>Throttling errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>4<\/td>\n<td>App-level API call limit reached<\/td>\n<td>Slow down and retry later<\/td>\n<\/tr>\n<tr>\n<td>80007<\/td>\n<td>WhatsApp Business Account rate limit reached<\/td>\n<td>Slow down and retry later<\/td>\n<\/tr>\n<tr>\n<td>130429<\/td>\n<td>Messages-per-second limit for the number reached<\/td>\n<td>Send more slowly and retry<\/td>\n<\/tr>\n<tr>\n<td>131048<\/td>\n<td>Sending limited because many messages were blocked or reported as spam<\/td>\n<td>Check quality and improve <a href=\"\/help\/whatsapp-opt-in-opt-out-rules\/\">opt-in<\/a> and content<\/td>\n<\/tr>\n<tr>\n<td>131056<\/td>\n<td>Too many messages to the same person in a short time<\/td>\n<td>Wait before messaging that person again<\/td>\n<\/tr>\n<tr>\n<td>131064<\/td>\n<td>Account limited after repeated wrong template categories<\/td>\n<td>Use the correct category; the limit lifts after the enforcement period<\/td>\n<\/tr>\n<tr>\n<td>133016<\/td>\n<td>Too many register or deregister attempts for the number<\/td>\n<td>Wait until the number is unblocked<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Other errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Invalid request or a server problem<\/td>\n<td>Check the request format and WhatsApp status<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Temporary downtime or overload<\/td>\n<td>Retry later<\/td>\n<\/tr>\n<tr>\n<td>33<\/td>\n<td>The business phone number no longer exists<\/td>\n<td>Check the phone number ID<\/td>\n<\/tr>\n<tr>\n<td>100<\/td>\n<td>A parameter is unsupported, misspelt or wrong (see <a href=\"https:\/\/www.fast2sms.com\/help\/how-to-fix-the-unsupported-post-request-error-in-whatsapp-business-api\/\">Unsupported POST request error<\/a>)<\/td>\n<td>Check the request against the API reference<\/td>\n<\/tr>\n<tr>\n<td>130403<\/td>\n<td>The customer has blocked your number<\/td>\n<td>Do not retry<\/td>\n<\/tr>\n<tr>\n<td>130472<\/td>\n<td>Marketing message held back as part of a Meta experiment<\/td>\n<td>No fix needed<\/td>\n<\/tr>\n<tr>\n<td>131000<\/td>\n<td>Something went wrong, cause unknown<\/td>\n<td>Retry; contact support if it continues<\/td>\n<\/tr>\n<tr>\n<td>131005<\/td>\n<td>Access denied, permission missing<\/td>\n<td>Check permissions<\/td>\n<\/tr>\n<tr>\n<td>131008<\/td>\n<td>A required parameter is missing<\/td>\n<td>Add the missing field<\/td>\n<\/tr>\n<tr>\n<td>131009<\/td>\n<td>A parameter value is invalid (often the phone number format)<\/td>\n<td>Check values and number format<\/td>\n<\/tr>\n<tr>\n<td>131016<\/td>\n<td>Service temporarily unavailable<\/td>\n<td>Retry later<\/td>\n<\/tr>\n<tr>\n<td>131021<\/td>\n<td>Sender and recipient are the same number<\/td>\n<td>Send to a different number<\/td>\n<\/tr>\n<tr>\n<td>131026<\/td>\n<td>Message undeliverable (not on WhatsApp, old app or terms not accepted)<\/td>\n<td>Check the number; use SMS for those contacts<\/td>\n<\/tr>\n<tr>\n<td>131037<\/td>\n<td>The number needs an approved display name<\/td>\n<td>Get the display name approved<\/td>\n<\/tr>\n<tr>\n<td>131042<\/td>\n<td>Billing or payment problem on the account<\/td>\n<td>Fix the payment setup<\/td>\n<\/tr>\n<tr>\n<td>131045<\/td>\n<td>The phone number is not registered<\/td>\n<td>Register the number<\/td>\n<\/tr>\n<tr>\n<td>131047<\/td>\n<td>More than 24 hours since the customer last replied<\/td>\n<td>Send an approved template<\/td>\n<\/tr>\n<tr>\n<td>131049<\/td>\n<td>Not delivered to keep user engagement healthy (see <a href=\"https:\/\/www.fast2sms.com\/help\/why-your-whatsapp-message-failed-with-maintain-healthy-ecosystem-error\/\">healthy ecosystem error<\/a>)<\/td>\n<td>Wait at least 24 hours before retrying<\/td>\n<\/tr>\n<tr>\n<td>131050<\/td>\n<td>The customer stopped marketing messages from you<\/td>\n<td>Do not retry<\/td>\n<\/tr>\n<tr>\n<td>131051<\/td>\n<td>Message type not supported<\/td>\n<td>Use a supported type<\/td>\n<\/tr>\n<tr>\n<td>131052<\/td>\n<td>Media sent by the customer could not be downloaded<\/td>\n<td>Ask the customer to send it again<\/td>\n<\/tr>\n<tr>\n<td>131053<\/td>\n<td>Your media could not be uploaded (often an unsupported file type)<\/td>\n<td>Check the file type and size<\/td>\n<\/tr>\n<tr>\n<td>131057<\/td>\n<td>The business account is in maintenance mode<\/td>\n<td>Wait and retry<\/td>\n<\/tr>\n<tr>\n<td>131063<\/td>\n<td>Marketing templates are switched off on the Cloud API for this account<\/td>\n<td>Send marketing through the Marketing Messages API<\/td>\n<\/tr>\n<tr>\n<td>132000<\/td>\n<td>Number of variables sent does not match the template<\/td>\n<td>Send exactly the template&#8217;s variables<\/td>\n<\/tr>\n<tr>\n<td>132001<\/td>\n<td>Template name or language not found, or not approved<\/td>\n<td>Check name, language and approval<\/td>\n<\/tr>\n<tr>\n<td>132005<\/td>\n<td>Translated text is too long<\/td>\n<td>Shorten the translation<\/td>\n<\/tr>\n<tr>\n<td>132007<\/td>\n<td>Template content breaks policy<\/td>\n<td>Edit as per the review rules<\/td>\n<\/tr>\n<tr>\n<td>132012<\/td>\n<td>A variable value is in the wrong format<\/td>\n<td>Match the expected format (text, media, currency)<\/td>\n<\/tr>\n<tr>\n<td>132015<\/td>\n<td>Template paused for low quality<\/td>\n<td>Edit the template and wait for approval<\/td>\n<\/tr>\n<tr>\n<td>132016<\/td>\n<td>Template disabled after being paused too often<\/td>\n<td>Create a new template<\/td>\n<\/tr>\n<tr>\n<td>132068<\/td>\n<td>The Flow is blocked<\/td>\n<td>Fix the Flow<\/td>\n<\/tr>\n<tr>\n<td>132069<\/td>\n<td>The Flow is throttled<\/td>\n<td>Fix the Flow<\/td>\n<\/tr>\n<tr>\n<td>133000<\/td>\n<td>An earlier deregistration did not finish<\/td>\n<td>Deregister again, then register<\/td>\n<\/tr>\n<tr>\n<td>133004<\/td>\n<td>Registration server temporarily unavailable<\/td>\n<td>Retry later<\/td>\n<\/tr>\n<tr>\n<td>133005<\/td>\n<td>Wrong two-step verification PIN<\/td>\n<td>Use the right PIN or reset it<\/td>\n<\/tr>\n<tr>\n<td>133006<\/td>\n<td>The number must be verified before registering<\/td>\n<td>Verify, then register<\/td>\n<\/tr>\n<tr>\n<td>133008<\/td>\n<td>Too many PIN attempts<\/td>\n<td>Wait for the time given in the details<\/td>\n<\/tr>\n<tr>\n<td>133009<\/td>\n<td>PIN entered too fast<\/td>\n<td>Wait and try again<\/td>\n<\/tr>\n<tr>\n<td>133010<\/td>\n<td>The phone number is not registered<\/td>\n<td>Register the number first<\/td>\n<\/tr>\n<tr>\n<td>133015<\/td>\n<td>The number was recently deleted and deletion is still running<\/td>\n<td>Wait about 5 minutes<\/td>\n<\/tr>\n<tr>\n<td>134011<\/td>\n<td>WhatsApp Payments terms not accepted<\/td>\n<td>Accept the terms<\/td>\n<\/tr>\n<tr>\n<td>135000<\/td>\n<td>Generic user error in the request<\/td>\n<td>Check the request; contact support if it continues<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Marketing Messages API errors<\/h2>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Code<\/th>\n<th>Meaning<\/th>\n<th>What to do<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>100<\/td>\n<td>Only template messages are allowed on this API<\/td>\n<td>Send a template<\/td>\n<\/tr>\n<tr>\n<td>131009<\/td>\n<td>Invalid values, or ad sync not finished<\/td>\n<td>Fix values; wait about 10 minutes<\/td>\n<\/tr>\n<tr>\n<td>131055<\/td>\n<td>Only marketing templates are supported<\/td>\n<td>Use a marketing template<\/td>\n<\/tr>\n<tr>\n<td>132018<\/td>\n<td>Template parameter problem<\/td>\n<td>Fix the parameters and resend<\/td>\n<\/tr>\n<tr>\n<td>134100<\/td>\n<td>Only marketing category templates are allowed<\/td>\n<td>Use a marketing template<\/td>\n<\/tr>\n<tr>\n<td>134101<\/td>\n<td>New template is still syncing<\/td>\n<td>Wait about 10 minutes, then retry<\/td>\n<\/tr>\n<tr>\n<td>134102<\/td>\n<td>Template unavailable (sync failed or account not eligible)<\/td>\n<td>Check eligibility; contact support<\/td>\n<\/tr>\n<tr>\n<td>1752041<\/td>\n<td>Duplicate onboarding request<\/td>\n<td>No action needed<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2>Fast2SMS reasons that are not Meta codes<\/h2>\n<p>Some failures are stopped by Fast2SMS before the message reaches Meta, or are marked by Fast2SMS. You see these texts in the Description column:<\/p>\n<div class=\"f2s-facts\">\n<table>\n<thead>\n<tr>\n<th>Text you see<\/th>\n<th>What it means<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Template is PAUSED \/ <a href=\"\/help\/whatsapp-template-rejected-invalid-format-appeal\/\">Template is REJECTED<\/a><\/td>\n<td>The template was paused or rejected by Meta before the message went out. Edit it or use another approved template.<\/td>\n<\/tr>\n<tr>\n<td>You can not send message to your own number<\/td>\n<td>The recipient is the same as your sender number.<\/td>\n<\/tr>\n<tr>\n<td>System has marked this message as failed<\/td>\n<td>Meta accepted the message but sent no status for 24 hours, so it was marked failed (and refunded).<\/td>\n<\/tr>\n<tr>\n<td>Batch cancelled by user<\/td>\n<td>The campaign was cancelled.<\/td>\n<\/tr>\n<tr>\n<td>This template was created by Meta Direct Send and can only be used with Direct Send&#8230;<\/td>\n<td>The template was made by Meta&#8217;s Direct Send feature and cannot be sent as a normal template. Pick another template.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<div class=\"f2s-note\">You may read about codes such as 131044, 131054, 131059, 131060, 131062 or 470 on other websites. They are not on Meta&#8217;s current error code list at the time of writing, so treat them as old codes and go by the details text Meta returns.<\/div>\n<section class=\"f2s-faq\">\n<h2>Frequently asked questions<\/h2>\n<h3>Where can I see the WhatsApp error code for a failed message?<\/h3>\n<p>Open <strong>Delivery Report<\/strong>, click the campaign and look at the <strong>Description<\/strong> column in <strong>Delivery Details<\/strong>. The code appears at the end, as &#8220;(Error: code)&#8221;.<\/p>\n<h3>Am I charged when a WhatsApp message fails with an error?<\/h3>\n<p>No. Every failed message is refunded to your Fast2SMS wallet automatically, whatever the error code.<\/p>\n<h3>What is the most common WhatsApp API error?<\/h3>\n<p>For most senders it is 131026, message undeliverable. It usually means the number is not on WhatsApp or the person uses an old app version.<\/p>\n<h3>Do I need a Meta access token to send WhatsApp through Fast2SMS?<\/h3>\n<p>No. Fast2SMS handles the connection to Meta for numbers you connect with <strong>Login with Facebook<\/strong>. Your API calls use your Fast2SMS API key in the authorization header.<\/p>\n<h3>Why does the same error code have different reasons?<\/h3>\n<p>Meta uses one code for several related causes. The details text tells you which one applies, so read it along with the code.<\/p>\n<h3>Will Fast2SMS retry failed WhatsApp messages?<\/h3>\n<p>Only if you turn on <strong>Retry Failed<\/strong> for the number in WhatsApp Manager. It retries messages that failed with 131026 or 131049, the next morning.<\/p>\n<\/section>\n<aside class=\"f2s-cta\" aria-label=\"Get started with Fast2SMS\"><div class=\"f2s-cta__copy\"><strong class=\"f2s-cta__title\">Start with the official WhatsApp API<\/strong><p>No setup fee. Connect your WhatsApp Business number and send your first template today.<\/p><\/div><div class=\"f2s-cta__actions\"><a class=\"f2s-cta__btn f2s-cta__btn--primary\" href=\"https:\/\/www.fast2sms.com\/\"><span>Sign up free<\/span> <span class=\"f2sh-btn__arrow\" aria-hidden=\"true\">&rarr;<\/span><\/a><a class=\"f2s-cta__btn f2s-cta__btn--ghost\" href=\"https:\/\/www.fast2sms.com\/meet\/\" target=\"_blank\" rel=\"noopener\">Book a free meeting<\/a><\/div><\/aside>\n<h2>Related guides<\/h2>\n<ul>\n<li><a href=\"\/help\/whatsapp-business-api-onboarding-fast2sms\/\">Connect your number to the WhatsApp Business API<\/a><\/li>\n<li><a href=\"\/help\/create-whatsapp-template-fast2sms\/\">Create a WhatsApp template in Fast2SMS<\/a><\/li>\n<li><a href=\"\/help\/send-bulk-whatsapp-messages-fast2sms\/\">Send bulk WhatsApp messages<\/a><\/li>\n<li><a href=\"https:\/\/www.fast2sms.com\/help\/why-your-whatsapp-message-failed-with-maintain-healthy-ecosystem-error\/\">Why a WhatsApp message failed with the &#8220;healthy ecosystem&#8221; error<\/a><\/li>\n<li><a href=\"https:\/\/www.fast2sms.com\/help\/whatsapp-template-rejected-approval-faq\/\">WhatsApp template rejected? Approval questions answered<\/a><\/li>\n<li><a href=\"https:\/\/www.fast2sms.com\/whatsapp-api\">Fast2SMS WhatsApp Business API<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>This page lists every WhatsApp API error code that Meta publishes for the WhatsApp Cloud API, with a one-line meaning and what to do about it. It also shows where you find the error code for a failed message in your Fast2SMS panel, so you can match the code to the fix in a minute. [&hellip;]<\/p>\n","protected":false},"featured_media":18280,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8,24],"tags":[],"class_list":["post-18283","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-delivery-report","category-whatsapp"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>WhatsApp API Error Codes: Full List and Fixes | Fast2SMS<\/title>\n<meta name=\"description\" content=\"Every WhatsApp API error code from Meta with a one-line meaning and fix, plus where to find the error for a failed message in your Fast2SMS panel.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"WhatsApp API Error Codes: Full List and Fixes | Fast2SMS\" \/>\n<meta property=\"og:description\" content=\"Every WhatsApp API error code from Meta with a one-line meaning and fix, plus where to find the error for a failed message in your Fast2SMS panel.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/\" \/>\n<meta property=\"og:site_name\" content=\"Fast2SMS\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/Fast2SMS\/\" \/>\n<meta property=\"article:published_time\" content=\"2026-11-18T18:24:43+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-11-18T19:26:43+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-failed-filter-hd-scaled.webp\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1600\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/webp\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@fast2sms\" \/>\n<meta name=\"twitter:site\" content=\"@fast2sms\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/\"},\"author\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\"},\"headline\":\"WhatsApp API error codes: full list with meaning and fix\",\"datePublished\":\"2026-11-18T18:24:43+00:00\",\"dateModified\":\"2026-11-18T19:26:43+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/\"},\"wordCount\":2207,\"publisher\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/whatsapp-delivery-report-failed-filter-hd-scaled.webp\",\"articleSection\":[\"Delivery Report\",\"WhatsApp\"],\"inLanguage\":\"en-IN\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/\",\"name\":\"WhatsApp API Error Codes: Full List and Fixes | Fast2SMS\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/whatsapp-delivery-report-failed-filter-hd-scaled.webp\",\"datePublished\":\"2026-11-18T18:24:43+00:00\",\"dateModified\":\"2026-11-18T19:26:43+00:00\",\"description\":\"Every WhatsApp API error code from Meta with a one-line meaning and fix, plus where to find the error for a failed message in your Fast2SMS panel.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/#breadcrumb\"},\"inLanguage\":\"en-IN\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-IN\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/whatsapp-delivery-report-failed-filter-hd-scaled.webp\",\"contentUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/whatsapp-delivery-report-failed-filter-hd-scaled.webp\",\"width\":2560,\"height\":1600,\"caption\":\"WhatsApp Reports page filtered to Last 30 days and Failed, showing 19 failed messages and a campaign list\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/whatsapp-api-error-codes-list\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Delivery Report\",\"item\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/delivery-report\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"WhatsApp API error codes: full list with meaning and fix\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/#website\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/help\\\/\",\"name\":\"Fast2SMS\",\"description\":\"Help\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\"},\"inLanguage\":\"en-IN\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#organization\",\"name\":\"Fast2SMS\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#logo\",\"url\":\"https:\\\/\\\/www.fast2sms.com\\\/Fast2SMS.png\",\"contentUrl\":\"https:\\\/\\\/www.fast2sms.com\\\/Fast2SMS.png\",\"caption\":\"Fast2SMS\"},\"image\":{\"@id\":\"https:\\\/\\\/www.fast2sms.com\\\/#logo\"},\"email\":\"support@fast2sms.com\",\"telephone\":\"+91-6262778822\",\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/Fast2SMS\",\"https:\\\/\\\/www.instagram.com\\\/fast2sms\",\"https:\\\/\\\/x.com\\\/fast2sms\",\"https:\\\/\\\/www.youtube.com\\\/Fast2SMSofficial\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/fast2sms\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"WhatsApp API Error Codes: Full List and Fixes | Fast2SMS","description":"Every WhatsApp API error code from Meta with a one-line meaning and fix, plus where to find the error for a failed message in your Fast2SMS panel.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/","og_locale":"en_US","og_type":"article","og_title":"WhatsApp API Error Codes: Full List and Fixes | Fast2SMS","og_description":"Every WhatsApp API error code from Meta with a one-line meaning and fix, plus where to find the error for a failed message in your Fast2SMS panel.","og_url":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/","og_site_name":"Fast2SMS","article_publisher":"https:\/\/www.facebook.com\/Fast2SMS\/","article_published_time":"2026-11-18T18:24:43+00:00","article_modified_time":"2026-11-18T19:26:43+00:00","og_image":[{"width":2560,"height":1600,"url":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-failed-filter-hd-scaled.webp","type":"image\/webp"}],"twitter_card":"summary_large_image","twitter_creator":"@fast2sms","twitter_site":"@fast2sms","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/#article","isPartOf":{"@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/"},"author":{"@id":"https:\/\/www.fast2sms.com\/#organization"},"headline":"WhatsApp API error codes: full list with meaning and fix","datePublished":"2026-11-18T18:24:43+00:00","dateModified":"2026-11-18T19:26:43+00:00","mainEntityOfPage":{"@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/"},"wordCount":2207,"publisher":{"@id":"https:\/\/www.fast2sms.com\/#organization"},"image":{"@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/#primaryimage"},"thumbnailUrl":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-failed-filter-hd-scaled.webp","articleSection":["Delivery Report","WhatsApp"],"inLanguage":"en-IN"},{"@type":"WebPage","@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/","url":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/","name":"WhatsApp API Error Codes: Full List and Fixes | Fast2SMS","isPartOf":{"@id":"https:\/\/www.fast2sms.com\/help\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/#primaryimage"},"image":{"@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/#primaryimage"},"thumbnailUrl":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-failed-filter-hd-scaled.webp","datePublished":"2026-11-18T18:24:43+00:00","dateModified":"2026-11-18T19:26:43+00:00","description":"Every WhatsApp API error code from Meta with a one-line meaning and fix, plus where to find the error for a failed message in your Fast2SMS panel.","breadcrumb":{"@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/#breadcrumb"},"inLanguage":"en-IN","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/"]}]},{"@type":"ImageObject","inLanguage":"en-IN","@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/#primaryimage","url":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-failed-filter-hd-scaled.webp","contentUrl":"https:\/\/www.fast2sms.com\/help\/wp-content\/uploads\/2026\/11\/whatsapp-delivery-report-failed-filter-hd-scaled.webp","width":2560,"height":1600,"caption":"WhatsApp Reports page filtered to Last 30 days and Failed, showing 19 failed messages and a campaign list"},{"@type":"BreadcrumbList","@id":"https:\/\/www.fast2sms.com\/help\/whatsapp-api-error-codes-list\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.fast2sms.com\/help\/"},{"@type":"ListItem","position":2,"name":"Delivery Report","item":"https:\/\/www.fast2sms.com\/help\/delivery-report\/"},{"@type":"ListItem","position":3,"name":"WhatsApp API error codes: full list with meaning and fix"}]},{"@type":"WebSite","@id":"https:\/\/www.fast2sms.com\/help\/#website","url":"https:\/\/www.fast2sms.com\/help\/","name":"Fast2SMS","description":"Help","publisher":{"@id":"https:\/\/www.fast2sms.com\/#organization"},"inLanguage":"en-IN"},{"@type":"Organization","@id":"https:\/\/www.fast2sms.com\/#organization","name":"Fast2SMS","url":"https:\/\/www.fast2sms.com\/","logo":{"@type":"ImageObject","@id":"https:\/\/www.fast2sms.com\/#logo","url":"https:\/\/www.fast2sms.com\/Fast2SMS.png","contentUrl":"https:\/\/www.fast2sms.com\/Fast2SMS.png","caption":"Fast2SMS"},"image":{"@id":"https:\/\/www.fast2sms.com\/#logo"},"email":"support@fast2sms.com","telephone":"+91-6262778822","sameAs":["https:\/\/www.facebook.com\/Fast2SMS","https:\/\/www.instagram.com\/fast2sms","https:\/\/x.com\/fast2sms","https:\/\/www.youtube.com\/Fast2SMSofficial","https:\/\/www.linkedin.com\/company\/fast2sms"]}]}},"_links":{"self":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts\/18283","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/comments?post=18283"}],"version-history":[{"count":1,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts\/18283\/revisions"}],"predecessor-version":[{"id":19474,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/posts\/18283\/revisions\/19474"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/media\/18280"}],"wp:attachment":[{"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/media?parent=18283"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/categories?post=18283"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.fast2sms.com\/help\/wp-json\/wp\/v2\/tags?post=18283"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}