Skip to main content
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

The URL must be publicly accessible via HTTPS, must not require authentication, and must point directly to the file (not to an HTML page).

Common Errors

  • INVALID_MEDIA_URL - The image URL is invalid or inaccessible
  • MEDIA_TOO_LARGE - The image exceeds the channel’s size limit
  • UNSUPPORTED_MEDIA_TYPE - The image format is not supported

Use Cases

  • Sharing product photos
  • Sending visual menus
  • Showing visual instructions
  • Sharing screenshots