Send short clips or demos with an optional caption — product walkthroughs, tutorials, or status updates with video.
At a glance
| Item | Detail |
|---|
type | video |
| Supported formats | MP4, 3GP |
| Maximum file size | 16 MB |
| Media field | content.media_url (aliases: media, url) |
| Caption | Optional content.caption |
| Channel support | Official and unofficial |
Use a direct HTTPS URL to the video file. Hosting pages that require redirects or authentication often fail delivery.
Request body
| Field | Required | Description |
|---|
channel_id | Yes | Sender channel ID |
to | Yes | Recipient phone number |
type | Yes | video |
content.media_url | Yes | HTTPS URL to the video file |
content.caption | No | Optional caption text |
Example
curl -X POST "https://api.wazapin.com/v1/messages" \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "wzp_abc123",
"to": "6281234567890",
"type": "video",
"content": {
"media_url": "https://cdn.example.com/videos/product-demo.mp4",
"caption": "Ini video cara pakainya"
}
}'
Endpoint
POST https://api.wazapin.com/v1/messages
Authenticate with X-Api-Key. See Authentication.
Response
On success, the API returns 201 Created with a message record (status often starts as queued).
{
"data": {
"id": "9f1fd66d-c37a-4b50-a8c2-b4dca523f9c8",
"channel_id": "wzp_abc123",
"to_phone": "6281234567890",
"type": "text",
"status": "queued",
"created_at": "2026-03-04T06:20:10Z",
"updated_at": "2026-03-04T06:20:10Z"
}
}
