Messages

Send Image Message

Send an image with an optional caption.

Home/Docs/Send Image Message

Endpoint

Send an image with an optional caption.

Request

POST /sendImage

Authentication

Every request must include a Bearer token in the Authorization header. Missing or invalid API keys return 401 Unauthorized.

Header

Authorization: Bearer YOUR_API_KEY

Request Body

Field	Type	Required	Description
session	string	Yes	Session ID
to	string	Yes	Recipient phone number
url	string	No*	Publicly accessible image URL
data	string	No*	Base64-encoded image data
caption	string	No	Image caption

Response

Field	Type	Description
id	string	Unique message identifier
to	string	Recipient phone number or group JID
content	string	Message content, media reference, or caption
type	string	Message type: text, image, video, document, or ptt
timestamp	string	ISO 8601 timestamp of when the message was sent
status	string	Delivery status such as sent, delivered, or read
fromMe	boolean	True when sent by the current session
sender	string	Sender phone number
recipient	string	Recipient identifier

Examples

cURL

curl -X POST "https://api.example.com/sendImage" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "msg_124",
  "to": "+1234567890",
  "content": "https://cdn.example.com/image.png",
  "type": "image",
  "timestamp": "2026-04-15T10:00:00.000Z",
  "status": "sent",
  "fromMe": true,
  "sender": "+1234567890",
  "recipient": "+1234567890"
}

Notes

Either url or data must be provided.