---
title: "Document message"
method: POST
path: "/message"
---

# Document message

`POST /message`

Send a V3 document message to a WhatsApp user using either a media ID or a hosted link

## Request body

- DocumentMessageRequest
  - `messaging_product` 'whatsapp', required — The messaging product used (currently only whatsapp)
  - `recipient_type` 'individual', required — The type of recipient (currently only individual)
  - `to` string, required — Destination phone number in E.164 format
  - `type` 'document', required — Message type (document for this API)
  - `document` union, required — Document object containing document details
    - object
      - `id` string, required — Media Object ID (required if not using link)
      - `link` string, uri — Publicly hosted URL of the document (required if not using id)
      - `caption` string — Description of the document (optional)
      - `filename` string — Custom filename for the document (optional)
    - object
      - `id` string — Media Object ID (required if not using link)
      - `link` string, uri, required — Publicly hosted URL of the document (required if not using id)
      - `caption` string — Description of the document (optional)
      - `filename` string — Custom filename for the document (optional)

## Response `200`

Successful response

- SuccessResponse
  - `status` string, required — Success message

## Other responses

- `400` — Bad Request
- `401` — Authentication Failed

---

[API](https://skmtc.net/gupshup/apis/partner-portal-public-apis.md) · [All operations](https://skmtc.net/gupshup/apis/partner-portal-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupshup/partner-portal-public-apis/revisions/1846573c8f87/schema)