Document

POST

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

Send documents that users can download and view directly in WhatsApp.

Supported document types

Document Type	Supported Formats	Maximum File Size
Text File	`.txt`	100 MB
Excel	`.xls`, `.xlsx`	100 MB
Word	`.doc`, `.docx`	100 MB
PowerPoint	`.ppt`, `.pptx`	100 MB
PDF	`.pdf`	100 MB

Only the listed document formats are officially supported and guaranteed to work correctly in WhatsApp. Other file types may not display properly.

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": "document",
    "document": {
        "link": "<DOCUMENT_URL>",
        "filename": "<FILE_NAME>",
        "caption": "<CAPTION>"
    }
}'

Response Example

200 - SUCCESS

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

Modified at 2026-07-29 11:09:43

Audio

Contacts

Document

Supported document types#

Request

Responses

Supported document types