# Video

Video messages display a thumbnail preview of a video image with an optional caption. When the WhatsApp user taps the preview, it loads the video and displays it to the user.

![](https://3527970750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4sMxKjL6eJRvZn6jeG-887967055%2Fuploads%2FHgTWHrtQo4HDRn634Ak4%2Fvideo.png?alt=media\&token=dc3ca95f-9e98-48f7-8b66-b7669132980d)

### Video Message Request

Use the messages endpoint to send a video message to a WhatsApp user.

<mark style="color:orange;">`POST`</mark> `https://waba-v2.360dialog.io/messages`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `D360-API-KEY`     |

**Body Example**

```json
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{wa-user-phone-number}}",
  "type": "video",
  "video": {
    "id" : "<MEDIA_ID>", /* Only if using uploaded media */
    "link": "<MEDIA_URL>", /* Only if linking to your media */
    "caption": "<VIDEO_CAPTION_TEXT>"
  }
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "contacts": [
    {
      "input": "text",
      "wa_id": "text"
    }
  ],
  "messages": [
    {
      "id": "text",
      "message_status": "accepted"
    }
  ],
  "messaging_product": "text"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}

### Supported Video Formats

Only the H.264 video codec and AAC audio codec are supported, with either a single audio stream or no audio stream. Videos encoded with the H.264 “High” profile and B-frames are not supported on Android WhatsApp clients. For broader compatibility, use the H.264 “Main” profile without B-frames or the H.264 “Baseline” profile when encoding (or re-encoding with a tool like ffmpeg), and place moov boxes before mdat boxes. When using ffmpeg, the `-movflags faststart` flag can be applied to place moov boxes before mdata boxes.

| Video Type | Extension | MIME Type  | Max Size |
| ---------- | --------- | ---------- | -------- |
| 3GPP       | .3gp      | video/3gpp | 16 MB    |
| MP4 Video  | .mp4      | video/mp4  | 16 MB    |