Image

POST

https://rest.qikberry.ai/v1/whatsapp/messages

Image messages are messages that display a single image and an optional caption.

Image with Caption Message

Supported image formats

Image Format	Extension	Maximum File Size
JPEG	`.jpeg`	5 MB
PNG	`.png`	5 MB

Note: Images must be in 8-bit RGB or RGBA format for WhatsApp compatibility.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

The request was successfully accepted for processing. The response returns a confirmation message along with the unique message ID and the recipient's WhatsApp number.

Bodyapplication/json

🟠401Unauthorized

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

cURL

With CaptionWithout Caption

curl --location 'https://rest.qikberry.ai/v1/whatsapp/messages' \
--header 'x-phone-number: <WA_ID>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "to": "<USER_PHONE_NUMBER>",
    "type": "image",
    "image": {
        "link": "<IMAGE_URL>",
        "caption": "<CAPTION>"
    }
}'

Response Example

200 - SUCCESS

{
    "message": "1 numbers accepted",
    "data": [
        {
            "messageId": "<MESSAGE_ID>",
            "mobile": "<USER_PHONE_NUMBER>"
        }
    ]
}

Modified at 2026-07-29 11:13:02

Contacts

Location

Image

Supported image formats#

Request

Responses

Supported image formats