# Media Message

To send a text message, make <mark style="color:red;">`POST`</mark> it to **`/{{Channel-ID}}/messages`** and attach a message media object, Whatsapp Business API supports media type as in the list below:

1. Audio Type
2. Document Type
3. Image Type
4. Sticker Type
5. Video Type

A successful response includes an object with an identifier prefixed with **`wamid`**. Use the **`wamid`** to track your message status.

To know what media type you can send, please see this [media type supported](/whatsapp-api/whatsapp-api/media.md)

#### Image  Message Payload Sample

```json
{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{Recipient-Phone-Number}}",
    "type": "image",
    "image": {
        "id": "Image ID from uploaded media in Media API",
        "link": "Use this field if you want to use media from your media storage"
        "caption":"Add caption to your image"
    }
}
```

#### Document Message Payload Sample

```json
{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{Recipient-Phone-Number}}",
    "type": "document",
    "document": {
        "id": "Document ID from uploaded media in Media API",
        "link": "Use this field if you want to use media from your media storage"
        "caption":"Add caption to your document"
    }
}
```

#### Audio Message Payload Sample

```json
{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{Recipient-Phone-Number}}",
    "type": "audio",
    "audio": {
        "id": "Audio ID from uploaded media in Media API",
        "link": "Use this field if you want to use media from your media storage"
    }
}
```

#### Sticker Message Payload Sample

```json
{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{Recipient-Phone-Number}}",
    "type": "sticker",
    "sticker": {
        "id": "Sticker ID from uploaded media in Media API",
        "link": "Use this field if you want to use media from your media storage"
    }
}
```

#### Video Message Payload Sample

```json
{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{Recipient-Phone-Number}}",
    "type": "video",
    "video": {
        "id": "Video ID from uploaded media in Media API",
        "link": "Use this field if you want to use media from your media storage"
        "caption":"Add caption to your video"
    }
}
```

{% hint style="info" %}
Please refer to this [document ](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages#media-object)as well to see the possible of `media object`
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-wa.neuapix.com/whatsapp-api/whatsapp-api/send-messages/media-message.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.