Webhook & Media Engineering 200 OK

WhatsApp Business API Video Specs, Size Limits & Encoding Guide

Video messages deliver high engagement for product teasers and customer reviews, but must strictly conform to Meta 16MB size limit and H.264 video codec.

Probable Causes

Video files failing to play or upload due to incompatible codecs (ProRes, HEVC)
Videos exceeding the strict 16MB mobile network limit

Step-by-Step Resolution

Recommended Fix Protocol:

Encode video files using H.264 codec (Baseline profile), AAC audio at 128 kbps, MP4 container, and keep overall file size strictly below 16MB.

Technical Example / Code Payload:

ffmpeg -i input.mov -c:v libx264 -pix_fmt yuv420p -profile:v baseline -c:a aac -b:a 128k output.mp4

Quick Answers

Frequently Asked Questions

What is the recommended video resolution?+

1080x1920 (9:16 vertical for mobile screens) or 1080x1080 (1:1 square).

Why do videos need the faststart flag?+

The faststart flag allows WhatsApp users to stream video instantly before the full file finishes downloading.

Need Technical Help?

Resolve WhatsApp API Issues Fast with NY Digital

Our certified Meta API engineering team helps Indian enterprises diagnose webhook bugs, unblock banned numbers, and scale messaging limits safely.

Speak with Our Engineering Team