Media

Media can be attached to the message you send to your customers or the message that comes from your customers, customers or your business can send media type supported below:

Media
Supported Types
Size Limit

audio

audio/aac, audio/mp4, audio/mpeg, audio/amr, audio/ogg (only opus codecs, base audio/ogg is not supported)

16MB

document

text/plain, application/pdf, application/vnd.ms-powerpoint, application/msword, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

100MB

image

image/jpeg, image/png

Images must be 8-bit, RGB or RGBA

5MB

video

video/mp4, video/3gp

Notes:

  • Only H.264 video codec and AAC audio codec is supported.

  • We support videos with a single audio stream or no audio stream.

16MB

sticker

image/webp

Static stickers: 100KB

Animated stickers: 500KB

You can use 2 APIs endpoints to manage your media, see UPLOAD & DOWNLOAD. gives an identifier for the specific media saved on your account, here is where the Media ID comes from

  1. From the upload API call, once you have successfully uploaded the media from the API, the Media ID will be included in the response to your API call.

  2. From Webhooks, When your Whatsapp Business Account receives a media message from your customer, it will include a Media ID that you can use to download to your system

Sample Use Case

  1. Send media messages to your customers, you can upload the media then use the Media ID as a payload in your request, see Send Media Message

  2. Media messages from your customers can be downloaded, you will receive a notification to your webhook contains Media ID.

Last updated