01Who this is for
- Marketing agencies that send WhatsApp campaigns, because they need to ensure media files comply with WhatsApp specifications.
- Ecommerce stores using WhatsApp for order confirmations, as broken media can prevent customers from receiving product images.
- Real estate teams sharing property videos, since large or improperly coded videos cause upload failures.
02Media upload errors, explained
Error 131053 is a WhatsApp Cloud API response that indicates the platform could not upload the attached media file. The error appears in the webhook payload when a message fails, and the error_data.details field often supplies a more specific reason such as an unsupported MIME type.
The platform only accepts certain file formats and size limits for each media type. Images must be JPEG or PNG under 5 MB, videos must be MP4 with H.264 video and AAC audio under 16 MB, audio files have specific codecs, documents can be up to 100 MB, and stickers must be static WebP at 512 × 512 pixels under 100 KB. Media sent via a URL must be publicly reachable over HTTPS, end with the correct file extension, and not redirect.
03How businesses use media upload errors
- Digital marketing agency. The agency checks the webhook error_data.details to see which MIME type was rejected. It then converts any WebP images to JPEG or PNG before re sending the broadcast. This ensures the media complies with WhatsApp’s supported formats.
- Online retailer. Before sending product videos, the retailer validates that the file is MP4, uses H.264 video and AAC audio codecs, and stays below 16 MB. If the video exceeds limits, they re encode it with HandBrake and resend the message.
- Health clinic. The clinic uploads appointment PDFs as document media. It confirms the file is under 100 MB and hosts it on a public HTTPS link that ends with .pdf. The link is tested in an incognito browser to guarantee public accessibility.
04The numbers and rules that matter
- Error code 131053 is titled "Media upload error"
- Image max size 5 MB, formats image/jpeg, image/png, must be 8 bit, RGB or RGBA.
- Video max size 16 MB, formats video/mp4, video/3gpp, must use H.264 video codec and AAC audio codec, single or no audio stream.
- Audio max size 16 MB, formats audio/aac, audio/mp4, audio/mpeg, audio/amr, audio/ogg (OPUS codec only).
- Document max size 100 MB, formats PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), and most common document formats.
- Sticker max size 100 KB, format image/webp only, static WebP, 512 × 512 px, transparent background.
05How to set up and use media upload errors in HighLevel
Resolve error 131053
- Open the webhook payload for the failed message and read the error_data.details field.
- Compare the actual file format with the supported media types table.
- Check the file size and verify it is below the maximum for its category.
- If the media is sent via a URL, confirm the URL uses HTTPS, is publicly reachable, ends with the correct file extension, and does not return a redirect.
- Re export or re save the file to remove hidden metadata and produce a clean version.
- If the upload still fails, gather the file details, full error response, and URL then submit a support ticket.
06Things to know before you rely on it
- Images must be JPEG or PNG and stay under 5 MB; WebP is only allowed for stickers.
- Videos are limited to 16 MB and must use H.264 video codec with AAC audio codec.
- Audio files have specific codec requirements and must be under 16 MB.
- Documents can be up to 100 MB and may include common office formats.
- Stickers must be static WebP, exactly 512 × 512 pixels, with transparent background, and under 100 KB.
- Media URLs must start with https://, be publicly accessible without authentication, end with a proper file extension, and must not return a 302 redirect.
07If something goes wrong
- Media still fails after meeting format and size requirements. Contact HighLevel support, providing the file type, size, full error response including error_data.details, and whether a URL or direct upload was used.
08How it connects to the rest of HighLevel
- Set up WhatsApp automation workflows in HighLevel WhatsApp workflow integration
- Create and manage WhatsApp templates WhatsApp templates
- Activate WhatsApp rebilling for agencies WhatsApp rebilling guide
Michael's take

Why does my WhatsApp media keep failing with error 131053? It usually means something about the file itself is off. The format, size, codec or even the link you’re using isn’t what WhatsApp expects.
If I were setting this up, I’d double check every media piece against the supported list, JPEG or PNG for images, MP4 with H.264/AAC for videos, and make sure any URL is a plain HTTPS link that ends with the right extension. A quick test in an incognito window saves you a lot of back and forth with support.