Messaging errors
Learn about errors that might occur when sending messages via any of our connected channels.
There might be situations where sending is not possible due to restrictions from Meta or a contact being not available on a specific channel. We communicate sending errors asynchronously by sending webhooks. You may subscribe to the sending_failed notification to receive those webhooks.
Please find a list of all potential errors below.
| Channel | Error type | Error title |
|---|---|---|
| contact_not_available | Contact is not available on WhatsApp. | |
| api_key_is_invalid | API key is not valid. | |
| channel_is_unauthorized | The communication channel is unauthorized. | |
| business_api_is_disabled | Your WhatsApp for Business API has been disabled. | |
| newly_created_account_cant_send_template | Newly created accounts can not send template message before being approved by Meta. | |
| parameters_is_not_required | Parameter is not required. | |
| parameters_not_matched | Number of parameters does not match the expected number of params. | |
| parameters_not_valid | Parameter value is not valid. | |
| required_parameters_missing | Required parameter is missing. | |
| template_not_exists | Template name does not exist in the translation. | |
| translated_text_too_long | The content of the message is too long. | |
| translation_not_found_for_language | Could not find translation for the requested language and locale. | |
| unregistered_for_business_api | Your WhatsApp for Business API is unregistered. | |
| server_error | An error occurred on the partner service. | |
| auth_exception | We were unable to authenticate the app user. | |
| api_exception | An error occurred while calling the API. | |
| permission_denied | Permission is either not granted or has been removed. | |
| access_token_expired | Access token has expired. | |
| invalid_parameter | The request included one or more unsupported or misspelled parameters. | |
| phone_deleted | The phone number has been deleted. | |
| account_locked | The account has been locked. | |
| message_rate_limit | The message rate limit has been exceeded. | |
| payment_issue | Payment issue occurred. | |
| media_upload_issue | File could not be uploaded. | |
| media_download_issue | File could not be downloaded. | |
| user_phone_in_experiment | Message was not sent as part of an experiment. | |
| re_engagement_message | The entertainment time slot (24h) has expired. | |
| spam_rate_limit_hit | The spam rate limit has been exceeded. | |
| Instagram/Facebook | person_is_unavailable | Person is currently unavailable. |
| Instagram/Facebook | token_has_not_permission | The token has not enough permissions to send messages. |
| Instagram/Facebook | token_is_expired | Current access token is expired. |
| Instagram/Facebook | user_not_found | No matching user found. |
| invalid_credential | Could not authenticate with the SMTP server. | |
| out_of_date_credential | Sending can not be performed because the account credentials are out of date. | |
| credential_not_verified | Could not verify access credential. | |
| invalid_message_id | Invalid message public id. | |
| account_deleted | Account is deleted. | |
| failed_send_all_recipients | Sending to all recipients failed. | |
| invalid_sender_address | Sender address is not valid. | |
| failed_send_smtp_error | Sending failed due to SMTP server connection error. | |
| resource_not_found | Resource not found. | |
| payload_too_large | The payload exceeds the maximum size. | |
| unsupported_media_type | The media type is not supported. | |
| unprocessable_entity | The entity could not be processed. | |
| rate_limit_exceeded | Rate limit exceeded. | |
| internal_server_error | Internal server error. | |
| service_unavailable | Service is unavailable. | |
| Telegram | blocked_by_user | User has blocked you. |
| Telegram | failed_to_get_content | Failed to get link content. |
| Telegram | file_is_too_big | File is too big to download. |
| SMS | authentication_error | Authentication error. |
| SMS | message_length_exceeds | The message body exceeds the character limit of 1600 characters. |
| SMS | invalid_mobile_number | Recipient number is not valid. |
| SMS | recipient_has_unsubscribed | Recipient has unsubscribed. |
| SMS | permission_not_enabled_indicated_region | Permission to send an SMS has not been enabled for the region indicated by recipient. |
| Google Business Chat | invalid_create_message_argument | Create message request contains invalid arguments. |
Updated 2 months ago