Message Types
Image
Send an image with optional text
POST
Path parameters
string
required
Unique identifier of the bot sending the message.
Body parameters
string
required
Message type. Must be
"image".string
required
Message recipient. Accepts a phone number in E.164 format without the leading
+ (e.g. 593999999999) or a BSUID (e.g. US.13491208655302741918) for users who have enabled phone number privacy in WhatsApp. See Identifying the recipient.string
required
Public (HTTPS) URL of the image file. Supported formats and maximum size depend on the channel (see the formats and limits by channel table).
string
Optional text shown alongside the media. WhatsApp only: Instagram and Messenger do not support text with an image; to send it, use a separate text message.
Response
boolean
true if the message was sent successfully.string
Identifier of the sent message.
Formats and size limits by channel
URL Requirements
Common Errors
INVALID_MEDIA_URL- The image URL is invalid or inaccessibleMEDIA_TOO_LARGE- The image exceeds the channel’s size limitUNSUPPORTED_MEDIA_TYPE- The image format is not supported
Use Cases
- Sharing product photos
- Sending visual menus
- Showing visual instructions
- Sharing screenshots