Image messages | Developer Documentation
Image messages
Updated: Nov 3, 2025
Image messages are messages that display a single image and an optional caption.
Request parameters
| Placeholder | Description | Example Value |
|---|---|---|
<ACCESS_TOKEN>String |
Required.
|
|
<API_VERSION>String |
Optional.
Graph API version. |
v25.0 |
<MEDIA_CAPTION_TEXT>String |
Optional.
Media asset caption text.
Maximum 1024 characters. |
The best succulent ever? |
<MEDIA_ID>String |
Required if using uploaded media, otherwise omit.
ID of the uploaded media asset. |
1013859600285441 |
<MEDIA_URL>String |
Required if using hosted media, otherwise omit.
URL of the media asset hosted on your public server. For better performance, we recommend using id and an uploaded media asset ID instead. |
https://www.luckyshrub.com/assets/succulents/aloe.png |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>String |
Required.
WhatsApp business phone number ID. |
106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>String |
Required.
WhatsApp user phone number. |
+16505551234 |
Supported image formats
Images must be 8-bit, RGB or RGBA.
| Image Type | Extension | MIME Type | Max Size |
|---|---|---|---|
|
JPEG |
.jpeg |
image/jpeg |
5 MB |
|
PNG |
.png |
image/png |
5 MB |