Message Types
Image
Send an image with optional text
POST
Path parameters
Body parameters
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.Public (HTTPS) URL of the image file. Supported formats and maximum size depend on the channel (see the formats and limits by channel table).
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
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