Video

POST

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

Video messages display a preview thumbnail with an optional caption and play when tapped by the user.

Video Message

Supported video formats

Video Format	Supported Extension	Maximum File Size
3GPP	`.3gp`	16 MB
MP4 Video	`.mp4`	16 MB

Note: Videos must use H.264 video encoding and AAC audio encoding 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": "video",
    "video": {
        "link": "<VIDEO_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:14:53

Location

Text

Video

Supported video formats#

Request

Responses

Supported video formats