Skip to main content
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

POST https://karibu.briq.tz/v1/whatsapp/messages/video
Headers: X-API-Key (required), Content-Type: application/json.

​
Fields

FieldTypeRequiredNotes
media_urlstringone sourcePublic HTTPS URL to the video.
file_idstringone sourceUploaded media id (first-party). Use media_url for external integrations.
captionstringnoOptional, up to 1024 characters.
to + sender—targetCustomer number (E.164) and which of your numbers to send from. sender is optional when you have one active number.
conversation_iduuidaltAlternative to to + sender: an existing thread to reply in.

​
Constraints

FormatsMP4 (video/mp4), 3GPP (video/3gpp)
CodecsH.264 video + AAC audio (single audio stream or none)
Max size16 MB
A 131053 error means the file is unsupported or too large (check codec and the 16 MB limit).

​
Example

cURL
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. Build and send a live request from the Send a video reference page.