# Video Messages

> Send WhatsApp video messages: MP4 clips with captions up to 16MB. Auto-thumbnails, fast CDN delivery and template support included.

Send videos for tutorials, product demos, or promotional content.

## Send a Video

```typescript
const message = await zavu.messages.send({
  to: "+14155551234",
  channel: "whatsapp",
  messageType: "video",
  content: {
    mediaUrl: "https://example.com/tutorial.mp4"
  }
});
```

```bash
curl -X POST https://api.zavu.dev/v1/messages \
  -H "Authorization: Bearer zv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "channel": "whatsapp",
    "messageType": "video",
    "content": {
      "mediaUrl": "https://example.com/tutorial.mp4"
    }
  }'
```

## Video with Caption

```typescript
const message = await zavu.messages.send({
  to: "+14155551234",
  channel: "whatsapp",
  messageType: "video",
  text: "How to use our app",
  content: {
    mediaUrl: "https://example.com/tutorial.mp4"
  }
});
```

```bash
curl -X POST https://api.zavu.dev/v1/messages \
  -H "Authorization: Bearer zv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "channel": "whatsapp",
    "messageType": "video",
    "text": "How to use our app",
    "content": {
      "mediaUrl": "https://example.com/tutorial.mp4"
    }
  }'
```

## Specifications

| Property | Requirement |
|----------|-------------|
| Formats | MP4, 3GPP |
| Max size | 16 MB |
| Codec | H.264 video, AAC audio |
| Caption | Optional, max 1024 chars |

## URL Requirements

Your video URL must:

- Be publicly accessible (no authentication)
- Use HTTPS
- Return the correct `Content-Type` header
- Be available for at least 24 hours

> **Tip:**
> Compress videos before uploading to ensure faster delivery and better user experience on mobile networks.

## Use Cases

- Product demonstrations
- Tutorial videos
- Promotional content
- Event highlights
- Customer testimonials