Send an Image

Sends a regular (non-template) WhatsApp Image message to a recipient phone number.

This endpoint is used for session messages (non-template).

You can optionally include a caption with up to 1024 characters.

💡

This endpoint can be used only when you have an active 24-hour customer service session with the recipient (i.e., the customer has messaged you within the last 24 hours and the conversation window is open). If there is no open session, you must use a template message instead.

Supported image formats & Sizes

Images must be 8-bit, RGB or RGBA.

Image Type	Extension	MIME Type	Max Size
JPEG	.jpeg	image/jpeg	5 MB
PNG	.png	image/png	5 MB

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "to": "966544351828",
    "type": "image",
    "document": {
        "link": "https://example.com/files/invoice-2025-0001.pdf",
        "caption": "مرفق فاتورتك رقم INV-2025-0001. إذا عندك أي استفسار رد على الرسالة."
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

{
    "data": {
        "id": 0,
        "message_id": "string",
        "from_id": "string",
        "to_id": "string",
        "timestamp": "string",
        "channel": "string",
        "source": "string",
        "type": "string",
        "direction": "string",
        "level": "string",
        "parent_message_id": 0,
        "thread_id": 0,
        "business_id": "string",
        "contact_id": 0,
        "forwarded": true,
        "sensitive": true,
        "mock": true,
        "spam": 0,
        "mentions": null,
        "agent_id": 0,
        "is_msg_read": true,
        "template_id": 0,
        "is_recorded": true,
        "close_reason_id": 0,
        "close_summary": "string",
        "CreatedAt": "string",
        "UpdatedAt": "string"
    },
    "message": "string",
    "success": true
}

Send an Image

Send an Image#

Supported image formats & Sizes#

Request

Request Code Samples

Responses

Send an Image

Supported image formats & Sizes