> ## Documentation Index
> Fetch the complete documentation index at: https://docs.briq.tz/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a video

> Send an MP4 or 3GPP video with an optional caption via POST /v1/whatsapp/messages/video.

Use `POST /v1/whatsapp/messages/video` for short demos and clips. Point at a publicly reachable `media_url`; WhatsApp fetches it **at send time**, so it must be reachable then and serve the correct `Content-Type`. Needs an **open 24-hour window**.

## Endpoint

```http theme={null}
POST https://karibu.briq.tz/v1/whatsapp/messages/video
```

**Headers:** `X-API-Key` (required), `Content-Type: application/json`.

## Fields

| Field             | Type   | Required   | Notes                                                                                                                 |
| ----------------- | ------ | ---------- | --------------------------------------------------------------------------------------------------------------------- |
| `media_url`       | string | one source | Public HTTPS URL to the video.                                                                                        |
| `file_id`         | string | one source | Uploaded media id (first-party). Use `media_url` for external integrations.                                           |
| `caption`         | string | no         | Optional, up to 1024 characters.                                                                                      |
| `to` + `sender`   | —      | target     | Customer number (E.164) and which of your numbers to send from. `sender` is optional when you have one active number. |
| `conversation_id` | uuid   | alt        | Alternative to `to` + `sender`: an existing thread to reply in.                                                       |

## Constraints

|          |                                                       |
| -------- | ----------------------------------------------------- |
| Formats  | MP4 (`video/mp4`), 3GPP (`video/3gpp`)                |
| Codecs   | H.264 video + AAC audio (single audio stream or none) |
| Max size | 16 MB                                                 |

A `131053` error means the file is unsupported or too large (check codec and the 16 MB limit).

## Example

```bash cURL theme={null}
curl -X POST "https://karibu.briq.tz/v1/whatsapp/messages/video" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "to": "255712345678", "media_url": "https://example.com/demo.mp4", "caption": "Quick demo" }'
```

Returns **202** `{ message_id, status: "pending" }`. Then [track delivery](/guides/whatsapp-track-messages). Build and send a live request from the [Send a video](/Karibu-WhatsApp/messages/send-video) reference page.