v1

latestOpenAPI 3.0.22026-08-045831103.6 KB

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"
  }
}