latestOpenAPI 3.0.22026-08-045831103.6 KB

12b8f9eff943

Messages

Send image message

Send an image message via WhatsApp Official. The image URL is sent directly to the Meta API (no upload required). Returns immediately with QUEUED status.

post/v2/messages/image

Headers

api-tokenstring required

API Token

Request body

channel_account_idstring uuid required

UUID of the WhatsApp Official channel account

contact_idstring uuid required

UUID of the contact to send the image to

urlstring uri required

Direct URL of the image to send

captionstring

Optional caption for the image

chat_idstring uuid

Optional UUID of an existing chat. If not provided, the system will find or create a chat automatically.

Example request

{
  "channel_account_id": "550e8400-e29b-41d4-a716-446655440001",
  "contact_id": "550e8400-e29b-41d4-a716-446655440002",
  "url": "https://example.com/photo.jpg",
  "caption": "Check out this photo!",
  "chat_id": "550e8400-e29b-41d4-a716-446655440003"
}

Response

Image message queued for sending

statusinteger

Example response

{
  "status": 200,
  "data": {
    "success": true,
    "message_id": "550e8400-e29b-41d4-a716-446655440099",
    "chat_id": "550e8400-e29b-41d4-a716-446655440003",
    "status": "QUEUED"
  }
}