Skip to contentSkip to navigationSkip to topbar
Page toolsOn this pageProducts used
Looking for more inspiration?Visit the

63019: Media failed to download


ERROR: 63019

error-63019 page anchor
MESSAGING
ERROR

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

Possible causes

possible-causes page anchor
  • 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.
  • 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

additional-resources page anchor