Messages

Send Video Message

Send a video with an optional caption.

Home/Docs/Send Video Message

Endpoint

Send a video with an optional caption.

Request

POST /sendVideo

Authentication

Every request must include a Bearer token in the Authorization header. Missing or invalid API keys return 401 Unauthorized.

Header

Authorization: Bearer YOUR_API_KEY

Request Body

Field	Type	Required	Description
session	string	Yes	Session ID
to	string	Yes	Recipient phone number
url	string	No*	Publicly accessible video URL
data	string	No*	Base64-encoded video data
caption	string	No	Caption text

Response

Field	Type	Description
id	string	Unique message identifier
to	string	Recipient phone number or group JID
content	string	Message content, media reference, or caption
type	string	Message type: text, image, video, document, or ptt
timestamp	string	ISO 8601 timestamp of when the message was sent
status	string	Delivery status such as sent, delivered, or read
fromMe	boolean	True when sent by the current session
sender	string	Sender phone number
recipient	string	Recipient identifier

Examples

cURL

curl -X POST "https://api.example.com/sendVideo" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "msg_127",
  "to": "+1234567890",
  "content": "video.mp4",
  "type": "video",
  "timestamp": "2026-04-15T10:00:00.000Z",
  "status": "sent",
  "fromMe": true,
  "sender": "+1234567890",
  "recipient": "+1234567890"
}

Notes

Either url or data must be provided.