ChatSyncs Help Center
Sign in
Browse guides

Video Messages

How to send a video message on the WhatsApp Cloud API, including supported formats, file size limits, and captions.

On this page

A video message sends a playable video clip to a recipient with an optional caption. Supported via public URL or media ID. See Media by URL vs Media ID.

Send by URL#

json
{
  "messaging_product": "whatsapp",
  "to": "919959623255",
  "type": "video",
  "video": {
    "link": "https://example.com/demo.mp4",
    "caption": "Watch this demo!"
  }
}

Send by Media ID#

json
{
  "messaging_product": "whatsapp",
  "to": "919959623255",
  "type": "video",
  "video": {
    "id": "1234567890",
    "caption": "Watch this demo!"
  }
}

Supported formats#

FormatMIME typeMax size
MP4video/mp416 MB
3GPvideo/3gpp16 MB
  • Only H.264 video codec and AAC audio codec are supported.
  • Caption is optional, max 1024 characters.

Frequently asked#

How do I send a video on WhatsApp API?

Set type to "video" and provide the video in video.link (public URL) or video.id (media ID). Only MP4 and 3GP under 16 MB are supported.

What video formats does WhatsApp support?

MP4 and 3GP, both under 16 MB. The video must use H.264 codec and AAC audio. Other formats must be converted before sending.

My video is sending but has no sound — why?

WhatsApp only supports AAC audio codec. If your video uses a different audio codec, re-encode it with AAC.

Gotchas & common mistakes#

Still stuck? Open a support ticket and our team will help.