Media download error
Failed to download the media from the sender
Group does not exist
Failed to send message because the group doesn't exist.
Business eligibility — Payment issue
Message is not valid
Failed to send message because it was too old.
Message failed to send during its Time To Live (TTL) duration.
Rate limit hit
Sender rate limit has been hit (server-side)
Unsigned Verified Name certificate
Occurs when a message is sent while the business does not have a valid, signed Verified Name certificate set on the server.
Verified Name certificate ID mismatch
Occurs when a message is sent but the business client's Verified Name certificate ID included in the message doesn't match what's been set on the server.
Verified Name certificate signature invalid
Occurs when a message is sent but the business client's Verified Name is not properly signed using the client's identity keys. This likely indicates that the client re-registered with new identity keys but did not go through the full cert creation flow.
Non-Message Template message sent more than 24 hours after the customer last messaged the business.
Spam Rate limit hit
Sender spam rate limit has been hit.
User's number is part of an experiment
WhatsApp runs experiments to measure and understand the impact of Business API notifications on user experience and the overall product in general. The recipient of this message is in one of these experiments, so will not receive notifications from you even if they have opted in.
A generic error occurred, see the "details" key in the error object for more specific info.
Message too long
Message length exceeds 4096 characters.
Invalid recipient type
Valid recipient types are:
Not a group participant
User is not a participant of the group.
Resource already exists
Possible UUID conflict for media upload request or media with that UUID already exists.
Resource not found
File or resource not found
Recipient blocked to receive message
Recipient is not whitelisted
Required parameter is missing
Missing a required parameter
Parameter value is not valid
Value entered for a parameter is of the wrong type or other problem.
Parameter is not required
Contains a parameter that is not required.
Service not ready
Group is unknown
You will receive this error when you send messages to a group in which you are the only member. Add some members to the group before sending messages.
User is not valid
Upload failed on bad image (image not uploaded correctly) or endpoint not found
Too many requests
Client-side rate limit has been hit
If the system is under heavy load, this error is returned to allow the system to recover from the load.
Not Primary Master
You receive this error when a master-only request, such as set settings, get settings, import, export, code request, register, etc. is sent to a node that is not a primary master. This could happen when the WhatsApp Business API Client is not setup properly or internal errors.
Not Primary Coreapp
You receive this error when requests are sent to a Coreapp node that is not the shard owner or in the process to become the shard owner. You might see this error when we are doing shard failover in the multiconnect setup.
Retrying the request should resolve this error most of time. If not, please contact Support.
Not a group admin
You will receive this message when you send a message to yourself.
Webhooks URL is not configured
You will receive this error if you have not configured the REST API Webhooks format.
Database error occurred
These are HTTP Status Codes that could be used by the WhatsApp Business API Client.
Successfully created (For POST requests)
Request was invalid
Method not allowed.
Message is rate limited
Too many requests
Internal server error