Supported media types and sizes
These are the types POST /v1/media/upload accepts, following
WhatsApp’s own limits. Files sent by link must meet the same limits; otherwise WhatsApp
rejects the send.
| Category | MIME types | Max size |
|---|---|---|
| Image | image/jpeg, image/png |
5 MB |
| Video | video/mp4, video/3gpp (video/3gp) |
16 MB |
| Audio | audio/aac, audio/amr, audio/mpeg, audio/mp4, audio/ogg (Opus codec only) |
16 MB |
| Document | application/pdf, text/plain, application/msword, application/vnd.ms-excel, application/vnd.ms-powerpoint, and the .docx, .xlsx and .pptx Office Open XML types |
100 MB |
| Sticker | image/webp |
500 KB |
Notes:
image/gifandimage/webparen’t valid image messages. WebP is only allowed as a sticker.- Video must use the H.264 video codec and AAC audio.
- A template header sample given as a URL in
example.header_handle(see Create a template) can be any file WhatsApp accepts for that header format; Hello fetches it and uploads it to WhatsApp for you.