September 7, 2026
Changed
WhatsApp can now send media
POST /api/v1/messages on a WhatsApp line (channel: "whatsapp") now accepts a single media attachment — the same media / mediaUrls fields as every other channel — where before it was text-only. More than one attachment is rejected with 400.
A body may accompany media only when the attachment is an image or video; a body alongside audio or a document is rejected with 400. A lone audio attachment is delivered as a voice note by default, and forceAudioFile: true delivers it as a regular audio file instead — mirroring how forceAudioFile already behaves on iMessage numbers. Supported attachment types are unchanged (images, audio, video, PDF, vCard, iCalendar); a vCard is delivered as a document, not a native contact card.
Nothing about the request shape changes — the fields already existed — so existing text-only WhatsApp sends are unaffected.