# Document messages | Developer Documentation

<div id="bkmrk-document-messagesupd">## Document messages

<div><span>Updated: Nov 3, 2025</span></div><div>Document messages are messages that display a document icon, linked to a document, that a WhatsApp user can tap to download.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-oyajztpa.png)</div><div id="bkmrk-request-parameters"><div id="bkmrk-request-parameters-1"><div>### Request parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr></thead><tbody><tr><td><div><div>`<ACCESS_TOKEN>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>[System token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation) or [business token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation).</div></div></td><td><div><div>```
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
```

</div></div></td></tr><tr><td><div><div>`<API_VERSION>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Graph API version.</div></div></td><td><div><div>v25.0</div></div></td></tr><tr><td><div><div>`<MEDIA_CAPTION_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Media asset caption text.</div><div>Maximum 1024 characters.</div></div></td><td><div><div>`Lucky Shrub Invoice`</div></div></td></tr><tr><td><div><div>`<MEDIA_FILENAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Document filename, with extension. The WhatsApp client will use an appropriate file type icon based on the extension.</div></div></td><td><div><div>`lucky-shrub-invoice.pdf`</div></div></td></tr><tr><td><div><div>`<MEDIA_ID>`</div><div>*String*</div></div></td><td><div><div>**Required if using uploaded media, otherwise omit.**</div><div>ID of the [uploaded media asset](/books/meta-whatsapp/page/media-developer-documentation).</div></div></td><td><div><div>`1013859600285441`</div></div></td></tr><tr><td><div><div>`<MEDIA_URL>`</div><div>*String*</div></div></td><td><div><div>**Required if using hosted media, otherwise omit.**</div><div>URL of the media asset hosted on your public server. For better performance, we recommend using `id` and an [uploaded media asset ID](/books/meta-whatsapp/page/media-developer-documentation) instead.</div></div></td><td><div><div>`https://www.luckyshrub.com/invoices/FmOzfD9cKf/lucky-shrub-invoice.pdf`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp user phone number.</div></div></td><td><div><div>`+16505551234`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-supported-document-t"><div id="bkmrk-supported-document-t-1"><div>### Supported document types

</div></div></div><div><table><thead><tr><th><span>Document Type </span></th><th><span>Extension </span></th><th><span>MIME Type </span></th><th><span>Max Size </span></th></tr></thead><tbody><tr><td><div><div>Text</div></div></td><td><div><div>.txt</div></div></td><td><div><div>text/plain</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Excel</div></div></td><td><div><div>.xls</div></div></td><td><div><div>application/vnd.ms-excel</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Excel</div></div></td><td><div><div>.xlsx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.spreadsheetml.sheet</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Word</div></div></td><td><div><div>.doc</div></div></td><td><div><div>application/msword</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft Word</div></div></td><td><div><div>.docx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.wordprocessingml.document</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft PowerPoint</div></div></td><td><div><div>.ppt</div></div></td><td><div><div>application/vnd.ms-powerpoint</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>Microsoft PowerPoint</div></div></td><td><div><div>.pptx</div></div></td><td><div><div>application/vnd.openxmlformats-officedocument.presentationml.presentation</div></div></td><td><div><div>100 MB</div></div></td></tr><tr><td><div><div>PDF</div></div></td><td><div><div>.pdf</div></div></td><td><div><div>application/pdf</div></div></td><td><div><div>100 MB</div></div></td></tr></tbody></table>

</div><div>Only the above listed document types are officially supported and guaranteed to display correctly in the WhatsApp client. Other file types may be sent via the API, but they are not supported and may not be handled as expected.</div></div>