---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/63019#article
headline: "63019: Media failed to download"
url: https://www.twilio.com/docs/api/errors/63019
inLanguage: en
dateModified: 2026-06-05T11:50:14.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 63019: Media failed to download

Log Type: APPLICATION

Log Level: ERROR

## Description

This error occurs when Twilio can't download media associated with a message. When this happens, the media retrieval returns 0 bytes.

### Possible causes

* The media attached by the sender could not be downloaded successfully.
* The media request succeeded but returned an empty file with 0 bytes.
* If you send outbound media with `MediaUrl`, the URL may not be serving the expected file or the `Content-Type` header may not match the actual media type. Twilio validates media URLs with `GET` and `HEAD` requests.
* The media may not meet channel requirements, such as supported MIME types or size limits. For example, outbound MMS media must stay within 5 MB total and outbound WhatsApp media must stay within 16 MB, with WhatsApp images limited to 5 MB.

### Possible solutions

* Check that the media file has content before retrying. If the file contains 0 bytes, upload a new copy or ask the sender to resend the attachment.
* Review the failed Message record or your `StatusCallback` payload to confirm the message `status`, `error_code`, and `error_message`.
* If you provide a `MediaUrl`, make sure the URL is publicly reachable by Twilio, serves the correct file, and returns a `Content-Type` header that matches the media you intend to send.
* Ensure media meets the supported file types and channel size limits before retrying.

#### Additional resources

* [Accepted content types for media](/docs/messaging/guides/accepted-mime-types)
* [Twilio's request to your incoming message webhook URL](/docs/messaging/guides/webhook-request)
* [Guidance on WhatsApp media messages](/docs/whatsapp/guidance-whatsapp-media-messages)