63019: Media failed to download
MESSAGING
ERROR
This error occurs when Twilio can't download media associated with a message. When this happens, the media retrieval returns 0 bytes.
- 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 theContent-Typeheader may not match the actual media type. Twilio validates media URLs withGETandHEADrequests. - 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
StatusCallbackpayload to confirm the messagestatus,error_code, anderror_message. - If you provide a
MediaUrl, make sure the URL is publicly reachable by Twilio, serves the correct file, and returns aContent-Typeheader that matches the media you intend to send. - Ensure media meets the supported file types and channel size limits before retrying.