Skip to main content
When WhatsApp refuses a message or can’t deliver it, Meta returns a numeric error code. Flowella turns most of the codes on this page into a plain-English reason. For the others, it shows WhatsApp’s own wording followed by the code in brackets. Use this page to find what a code means, where Flowella shows it and what to do next. The sections below cover the codes Flowella translates. All WhatsApp error codes lists every other code Meta documents. If a message failed without a code, start with Messages not delivered.

Where you see error codes

Delivery errors

These codes appear when WhatsApp doesn’t deliver a message, or refuses it as Flowella sends it. You see them in the Inbox, in the template’s Send log and in HubSpot workflow history.
The 24-hour window is Meta’s customer service window: the 24 hours after a customer’s latest message to you. Inside it you can send free-form messages. Outside it you need an approved template. See The 24-hour customer service window.

Template errors when you send

These appear when you send a template whose values don’t fit it, for example from Test Template, a bulk send, the Inbox or a HubSpot workflow.

Template errors when you publish

These appear as a message in the template editor when you select Publish Template or Save Template and Meta refuses the template. The template doesn’t go into review. Fix the problem and publish again. If Meta rejects a template after review, see Template rejected.

Flow publishing errors

These appear on the Flows page when Flowella can’t create or publish a WhatsApp Flow from a HubSpot form. For every badge, see Sync errors. For errors when you send a Flow, and endpoint errors, see Flows error codes. Code 133010 can also stop a template send. HubSpot then shows FLOWELLA_META:phone_not_registered.

Rate limits and Meta outages

Other codes you may see

For codes that aren’t on this page, Flowella shows WhatsApp’s own wording with the code in brackets. Look the code up in Meta’s error codes reference. Two that people often meet:

All WhatsApp error codes

Every code in Meta’s Cloud API reference, grouped by what it’s about. For codes Flowella doesn’t translate, it shows WhatsApp’s own wording with the code. Codes marked with a guide have their own page.

Access and permissions

These codes mean Meta refused Flowella’s access to your account, not a single message. If the Templates page shows “Templates from Meta couldn’t be loaded. Verify the integration in Settings”, Flowella couldn’t read your templates from Meta. This usually means Flowella has lost access to your WhatsApp Business Account, or Meta has disconnected the number, even though Flowella still shows WhatsApp as Connected. It can also happen briefly during a Meta outage. See Fix a WhatsApp number that shows Connected but doesn’t work.

Account integrity

Speed and volume limits

Daily limits on how many people you can message are covered in Messaging limits, and messages per second in Throughput.

Sending messages

Templates when you send

Templates when you publish or edit

The codes Flowella translates are in Template errors when you publish. Meta also returns:

Phone number registration and moves

WhatsApp Flows

132068 (Flow blocked), 132069 (Flow throttled) and 139000 to 139006 (publishing) are explained in Flows error codes.

Usernames

131062 is above. Errors from claiming or changing a business username, such as 147001 (username not available) and 147002 (account not eligible), are in Business username.

Connecting WhatsApp and co-existence

Errors in Meta’s sign-up popup are in Sign-up popup errors. Two more apply to numbers that also use the WhatsApp Business app:

Error codes in HubSpot

When WhatsApp fails a message sent by Send WhatsApp Template, Send WhatsApp Message or Send WhatsApp Reply, the action’s Error code output usually starts with FLOWELLA_META:. The error message in the workflow history shows the same code. For codes Flowella doesn’t translate, the error code is FAILED and the error message gives WhatsApp’s wording and the number. The same happens when WhatsApp refuses a Send WhatsApp Message or Send WhatsApp Reply message straight away. For codes that come from Flowella rather than WhatsApp, such as CONTACT_OPTED_OUT, see Send action failure codes.

Messages not delivered

Work out why a message didn’t arrive, with or without a code.

HubSpot sync failures

Fix workflow actions that fail and Flow answers missing from HubSpot.

Template rejected

Find Meta’s reason for a rejection and resubmit the template.

Quality rating

How Meta rates your number and templates, and how to recover.

Meta payment method

Add a default card to your WhatsApp Business Account.

Messaging limits

How many people your business portfolio can message each day.
Checked against Meta’s WhatsApp error codes, WhatsApp Flows error codes, business-scoped user IDs and thread control pages on 18 November 2026.
Last modified on November 18, 2026