WhatsApp error 131053: Media upload error
Last verified against Meta for Developers - Cloud API error codes
Unable to upload the media used in the message.What error 131053 means
Code 131053 means the media you attached to an outbound message could not be uploaded or processed by the platform, so the message was not sent. It most often appears when you send media by link rather than by media ID: the platform has to fetch your URL, and anything that goes wrong with that fetch (a redirect, a slow host, an authentication wall, a wrong Content-Type, or a file that is not actually the format its extension claims) surfaces as 131053. It can also appear for media IDs when the underlying file turns out to be unsupported or corrupt.
Meta's advice is practical: check error_data.details in the messages webhook, then inspect the file's real MIME type with a tool such as file -I and confirm it is on the supported list. The documentation also recommends uploading media to Meta first rather than linking, both for reliability and for higher throughput.
The recipient and window are not the problem, and the same asset will fail for everyone until it is fixed.
Why it happens
- A link URL that is not publicly reachable, redirects, requires cookies or auth, or is slow to respond.
- The server serving the link returns an incorrect Content-Type or an HTML error page.
- A file whose actual format does not match its extension, such as a PNG renamed to .jpg, or a video in an unsupported codec.
- File size over the documented limit for its type (5 MB image, 16 MB video and audio, 100 MB document).
- Corrupt or truncated media produced by a broken export step.
How to fix WhatsApp error 131053
- 1Read the errors array in the statuses webhook for this message and note error_data.details.
- 2Verify the file's real MIME type and size locally; convert or compress if it is unsupported or too large.
- 3Upload the file with POST /{phone-number-id}/media and send using the returned id instead of a link.
- 4If you must use links, make them direct, public, fast, and served with the correct Content-Type and no redirects.
- 5Retry the send with the new media ID.
How to stop it recurring
Upload media to Meta ahead of time and reference it by ID; reserve links for cases where hosting is unavoidable, and then test each hosting domain from outside your network. Validate MIME type and size before upload, and cache media IDs with timestamps so they are refreshed before their 30-day expiry. Size and format ceilings per media type are tabulated in the media limits table; a type-level rejection (rather than a fetch failure) surfaces as 131051.
Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.
Related codes
Error 131053 - quick answers
What does WhatsApp error 131053 mean?
Code 131053 means the media you attached to an outbound message could not be uploaded or processed by the platform, so the message was not sent.
How do I fix WhatsApp error 131053?
1. Read the errors array in the statuses webhook for this message and note error_data.details. 2. Verify the file's real MIME type and size locally; convert or compress if it is unsupported or too large. 3. Upload the file with POST /{phone-number-id}/media and send using the returned id instead of a link. 4. If you must use links, make them direct, public, fast, and served with the correct Content-Type and no redirects. 5. Retry the send with the new media ID.
Stop debugging WhatsApp by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.