Send a Document

Sends a regular (non-template) WhatsApp document 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.

You can also optionally set a file name for the document while sending it. If you don’t provide a file name, WhatsApp will display it as Untitled .

💡

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 document types and sizes

Document Type	Extension	MIME Type	Max Size
Text	.txt	text/plain	100 MB
Microsoft Excel	.xls	application/vnd.ms-excel	100 MB
Microsoft Excel	.xlsx	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	100 MB
Microsoft Word	.doc	application/msword	100 MB
Microsoft Word	.docx	application/vnd.openxmlformats-officedocument.wordprocessingml.document	100 MB
Microsoft PowerPoint	.ppt	application/vnd.ms-powerpoint	100 MB
Microsoft PowerPoint	.pptx	application/vnd.openxmlformats-officedocument.presentationml.presentation	100 MB
PDF	.pdf	application/pdf	100 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": "document",
    "document": {
        "link": "https://example.com/files/invoice-2025-0001.pdf",
        "filename": "فاتورة-INV-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 a Document

Send a Document#

Supported document types and sizes#

Request

Request Code Samples

Responses

Send a Document

Supported document types and sizes