Skip to contentSkip to navigationSkip to topbar
Page tools
Useful for sharing or LLM
Accelerate development with AI

On this pageProducts used
Looking for more inspiration?Visit the
Error
Application error

63019: Media failed to download

Twilio Messaging DocumentationMessaging

Description

description page anchor

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