Message Status Table

Status code

Callbacks; Query Message Response (description presented to clients)

Short Description

Details

1

UNKNOWN

Message not found

The specified message was not found in the account. Please check the account details and message ID to ensure these are correct.

2

QUEUED

Queued

The message has been queued for delivery. This is a temporary status – please check again in a few hours.

3

SCHEDULED

Scheduled for later delivery

The message is scheduled for later delivery. Review the message in a few hours to check on delivery.

4

SENT_TO_SUPPLIER

Sent to supplier

This message has been submitted to an external supplier. (For WhatsApp messages, this means Meta.)

5

DEVICE_ACK

Device acknowledged delivery

Two gray checkmarks on WhatsApp. The message was delivered successfully to the customer’s device. (WhatsApp-specific behavior)

6

READ

Read receipt

Two blue checkmarks on WhatsApp. The customer has read or opened the message. (WhatsApp-specific behavior)

20

EXPIRED

Message has expired

Validity period or internal validity period-related.

21

STOPPED_BY_USER

Message stopped by the user

22

STOPPED_BY_ADMIN

Message stopped by admin

23

DELIVERY_FAILURE

Error delivering message

Generic upstream supplier returned a permanent error. Could also be an internal error.

24

EMULATED

Emulated

Used for sandbox messaging when the number being sent to has not been added as a test phone.

25

INSUFFICIENT_ACCOUNT_BALANCE

Insufficient account balance

Review your account balance and ensure you have enough funds available.

26

VOLUME_LIMIT

Volume limit exceeded

27

VOLUME_LIMIT_DAILY

Daily volume limit exceeded

Applies to the sandbox environment.

28

VOLUME_LIMIT_MONTHLY

Monthly volume limit exceeded

Applies to the sandbox environment.

29

RECIPIENT_DOES_NOT_EXIST

Recipient does not exist on the channel

60

ENCRYPTION_ACCESS_DENIED

Security access denied

Credentials are invalid or have expired.

61

ENCRYPTION_CONTENT_ERROR

Content decryption failed

62

ENCRYPTION_VALIDATION_ERROR

Encryption validation error

Possible causes:

• The media file was expected to have an encryptionKey field, but it was not present.
• Mixing encrypted messages with non-encrypted media or vice versa.

80

MEDIA_NOT_FOUND

Media not found

Ensure that media is present in your upload environment and that it adheres to supported media types and sizes. 

81

MEDIA_SIZE_ERROR

Media size error

Your media size is too large. Reference this page for guidelines.

82

MEDIA_CHECKSUM_FAILURE

Media checksum failure

83

MEDIA_REJECTED_BY_SUPPLIER

Channel supplier rejected media file

Ensure that media is present in your upload environment and that it adheres to supported media types and sizes.

84

MEDIA_METADATA_ERROR

Metadata for the media file was not found or does not match the message request

Please reference the One API documentation to ensure that all required metadata is present.

85

MEDIA_ACCESS_ERROR

An access/permissions-related error occurred when handling the media file

Ensure that the media file is present and can be accessed by your system.

86

MEDIA_TYPE_NOT_SUPPORTED

The media type is not supported on the channel.

This specific media format is not supported on the channel. See here for guidelines.

100

ROUTING_ERROR

Routing error

 This SMS message did not route correctly.

130

WHATSAPP_ACCOUNT_PAYMENT_ISSUE

WhatsApp account payment issue

There is a payment issue related to this account.

131

WHATSAPP_RE_ENGAGEMENT_REQUIRED

Re-engagement required

The business must engage the client with an approved message template to initiate a new conversation.

132

WHATSAPP_SPAM_RATE_LIMIT_REACHED

Spam rate limit reached

Relates to Whatsapp Rate Limit and message quality.

133

WHATSAPP_SERVER_RATE_LIMIT

WhatsApp server rate limit

Your environment’s rate limit has been reached. Speak to your Technical Account Manager (TAM) about how to address this.

139

WHATSAPP_EXPERIMENTAL_NUMBER

Non-delivery due to WhatsApp experimental number feature

Meta has initiated an experiment on this number.

140

WHATSAPP_TEMPLATE_TEXT_TOO_LONG

Length of the parameters and the template text exceeds the maximum allowed length

141

WHATSAPP_TEMPLATE_FORMAT_MISMATCH

Specified template header is not in the expected format

There is a problem with the template header. See here for guidelines. See here for guidelines on setting up message templates.

142

WHATSAPP_TEMPLATE_FORMATTING_POLICY_VIOLATED

Template header parameter formatting is not allowed (bold, italic, etc.)

There is a problem with the template header. See here for guidelines on setting up message templates.

143

WHATSAPP_TEMPLATE_MEDIA_FORMAT_UNSUPPORTED

Correct media type is used in the template, but the mime type is unsupported

144

WHATSAPP_PARAMETER_MISSING

Required parameter is missing for this message

145

WHATSAPP_PARAMETER_INVALID

A message parameter contains an invalid value

146

WHATSAPP_PARAMETER_NOT_REQUIRED

A parameter was specified for the message that is not required

147

WHATSAPP_TEMPLATE_INVALID_URL

Invalid hydrated URL received in the message template 

Ensure that the URL used in the message template is valid.

148

WHATSAPP_TEMPLATE_INVALID_PHONE_NUMBER

Phone number in the template message is missing

Ensure that a valid telephone number is present in the message template.

149

WHATSAPP_TEMPLATE_RECEIVER_NO_BUTTON_SUPPORT

End-user device does not support buttons

150

WHATSAPP_TEMPLATE_DOES_NOT_EXIST

The template does not exist in the specified language or has not been approved.

There is a problem with the template status. Review these guidelines.

151

WHATSAPP_TEMPLATE_PARAM_COUNT_MISMATCH

WhatsApp’s API indicated that the number of parameters provided does not match the expected number. 

There is a problem with the template. Review these guidelines.

152

WHATSAPP_TEMPLATE_PAUSED

The template is in a paused status in the Meta account

The template has been paused due to negative feedback from customers. Edit the template to improve template quality.

153

WHATSAPP_TEMPLATE_DISABLED

The template is in a disabled status in the Meta account

The template has been disabled due to continuous poor feedback from customers. Please create a new template and follow these recommendations.

160

WHATSAPP_COMPLIANCE_INFO_MISSING

The business has not provided any compliance information

Relevant to WhatsApp commerce messaging. Currently only applies to businesses in India.

161

The catalog ID you provided either does not exist, does not belong to your WhatsApp Business Account, or is not connected to the phone number you are using to send the message

Relevant to WhatsApp commerce messaging. Review your catalog ID in Facebook Business Manager. See here for guidelines.

162

WHATSAPP_PRODUCT_NOT_FOUND_IN_CATALOG

The product provided in a single-product message or all of the products provided in a multi-product message was not found in the catalog ID provided

Relevant to WhatsApp commerce messaging. Review your catalog ID in Facebook Business Manager. See here for guidelines.

163

WHATSAPP_PRODUCT_COMPLIANCE_ERROR

The product provided in a single-product message or all of the products provided in a multi-product message are missing or have incomplete e-commerce compliance information

Relevant to WhatsApp commerce messaging. Currently only applies to businesses in India.

Review your catalog ID in Facebook Business Manager. See here for guidelines.

170

WHATSAPP_MESSAGE_UNDELIVERABLE

Message undeliverable

Your message has not been delivered. For WhatsApp, ensure:

• The end-user has WhatsApp installed on their phone.
• The end-user did not block the specific business number.
• The end-user has opted in to receive WhatsApp messages from the business.
• The business is not spamming the end-user with marketing message templates that the client doesn’t respond to. Meta blocks messages in this scenario.

171

WHATSAPP_CHOSE_NOT_TO_DELIVER

Meta chose not to deliver the message to maintain healthy ecosystem engagement

Too many marketing messages are being sent to this number without engagement from the client.

283

PAYMENT_COMPLETED

Payment completed

Payment was completed successfully.

284

PAYMENT_DECLINED

Payment declined

Payment was not completed successfully.

285

PAYMENT_FAILED

Payment failed

A failure was encountered in the payment (not completed and not declined).

286

PAYMENT_INVALID_MERCHANT_SESSION

Invalid merchant session

A valid merchant session was not provided.

287

PAYMENT_INVALID_WEBHOOK_ENDPOINTS

Invalid webhook endpoints

Valid webhook endpoints were not provided.