WhatsApp Error: Message Type Is Not Supported (Fix)

By Sparkforge Support Team ·Last reviewed May 3, 2026

WhatsApp's "Message type is currently not supported" error means you tried to send a format or media type its Business API doesn't accept. Use approved file types, approved templates, and link out to anything WhatsApp blocks.

The error Message type is currently not supported means WhatsApp's Business API rejected the format or media you tried to send. The fix is to match WhatsApp's allowed formats and templates.

Why This Happens

Unsupported media type

File formats WhatsApp blocks, like .exe, .zip, or .tar.
WhatsApp accepts only specific images, documents, audio, and video files.

Unsupported message type

Custom buttons or interactive structures the API doesn't support.
Document messages with captions are not currently supported.
Stickers, GIFs, and other non-standard formats are blocked.

Template restrictions

A template body or header may include a parameter type that isn't supported.

How to Fix It

Check your media file format

Use only WhatsApp-approved file types:

Images: JPG, JPEG, PNG
Documents: PDF, DOCX, PPTX, XLSX, TXT
Audio: AAC, MP3, OGG
Video: MP4 (max 16MB)

Check message content

Don't send stickers, GIFs, or other unsupported formats.
Use approved templates for proactive outbound messages.

Reconfigure templates

Make sure the template is approved and follows Meta's formatting rules.
Remove unsupported parameters and any dangling placeholders.

Send as a different type

If WhatsApp won't take the format, host the file elsewhere (Google Drive, Dropbox, etc.) and send the link instead.

Example

Wrong: attaching a .zip file directly to a WhatsApp message.
Right: upload the .zip to Google Drive and paste the share link in your message.

Reference

Meta's full WhatsApp on-premises error reference: developers.facebook.com/docs/whatsapp/on-premises/errors.

Frequently Asked Questions

What file types does WhatsApp accept?

Images as JPG/JPEG/PNG, documents as PDF/DOCX/PPTX/XLSX/TXT, audio as AAC/MP3/OGG, and video as MP4 up to 16MB.

Can I send GIFs through WhatsApp?

No. WhatsApp's Business API blocks GIFs and stickers. Convert to MP4 video or send the file as a link instead.

Why does my document with a caption fail?

Document messages with captions are not currently supported. Send the document and the caption text as separate messages.

How do I send a .zip file?

WhatsApp blocks .zip directly. Upload it to a host like Google Drive or Dropbox and send the link in the message body.

Why is my approved template still failing?

Check that the body and header parameters match the template's approved format. Unsupported parameter types or empty placeholders cause this error.