---
schema_version: "1"
id: 17f1fbf526e12ab28427c8e3c55e5dc50554062b81788db3df747dc3fbe651b6
title: WhatsApp Status Errors in Marketing Cloud Engagement
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mc_jb_whatsapp_errors.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mc_jb_whatsapp_errors.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 5b03c5bc0845f07faf8a0de5ee48b739505167947a2e6d21882d930707bdcc95
description: Review WhatsApp status errors. These status errors are generated by WhatsApp and are subject to change.
products:
  - Marketing
  - Marketing Cloud Engagement
release: "264"
---
# WhatsApp Status Errors in Marketing Cloud Engagement

Review WhatsApp status errors. These status errors are generated by WhatsApp and are subject to change.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
      <colgroup>
        <col style="width:50%">
        <col style="width:50%">
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d28487e39">Error</th>
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d28487e42">Description</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">MEDIA_TOO_LARGE</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">The media used in the message is above the 5-MB limit specified by WhatsApp.</td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">MEDIA_TYPE_UNSUPPORTED</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">The media used in your message is an unsupported type. Upload a JPEG or PNG.</td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">BAD_REQUEST</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">
            <p>One of these descriptions: </p>
            <ul>
              <li>Message length exceeds 4,096 characters.</li>
              <li>A required parameter is missing.</li>
              <li>The value entered for a parameter is of the wrong type or other problem.</li>
              <li>Message contains a parameter that isn’t required.</li>
              <li>The request isn’t valid.</li>
              <li>Parameter length is too long.</li>
              <li>Translated text is too long.</li>
              <li>Whitespace policy is violated.</li>
              <li>Format character policy is violated.</li>
              <li>The template media format used isn’t supported.</li>
              <li>A required component in the template is missing.</li>
              <li>URL in the button component is invalid.</li>
              <li>Phone number in button component is invalid.</li>
              <li>Parameter format doesn’t match the format in the created template.</li>
            </ul>
          </td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">MEDIA_NOT_REACHABLE </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">Failed to download the media from the sender.</td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">CHANNEL_BAD_CONFIGURATION</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">Channel rejected the given channel credentials.</td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">DELIVERY_TIMED_OUT</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">
            <p>One of these descriptions: </p>
            <ul>
              <li>Message failed to send because it was pending for too long. Resend the message. </li>
              <li>Message failed to send during its Time To Live (TTL) duration.</li>
            </ul>
          </td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">DELIVERY_REJECTED_DUE_TO_POLICY</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">Message failed to send because there are restrictions on how many messages can be sent
            from this phone number. This failure can occur if too many messages were blocked or flagged
            as spam.</td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">RECIPIENT_INVALID_CHANNEL_IDENTITY</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">
            <p>One of these descriptions:</p>
            <ul>
              <li>Failed to send the message because this user's phone number is part of an experiment.
                Skip sending messages to this user.</li>
              <li>Message failed to send since the user with this phone number has potentially
                changed.</li>
              <li>User isn’t valid.</li>
              <li>You can’t send messages to yourself.</li>
            </ul>
          </td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">TEMPLATE_INSUFFICIENT_PARAMETERS</td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">Number of parameters provided doesn’t match the expected number of parameters.</td>

        </tr>
        <tr class="">
          <td data-label="Error" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e39 ">RECIPIENT_NOT_REACHABLE </td>

          <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d28487e42 ">Given channel identity isn't reachable on this WhatsApp channel.</td>

        </tr>
      </tbody>
    </table>

#### See Also

- [_Meta_: Cloud API Error Codes](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/)