Skip to main content
POST
/
{instance}
/
send-video
curl --request POST \
  --url https://app.hypersender.com/api/whatsapp/v2/{instance}/send-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chatId": "[email protected]",
  "url": "https://hypersender.com/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Flogo.52c242e8.png&w=640&q=75",
  "fileName": "hypersender_logo",
  "mimetype": "image",
  "caption": "string",
  "reply_to": "string"
}
'
{
  "key": {
    "remoteJid": "[email protected]",
    "fromMe": true,
    "id": "3EB089F063C03E43EECE9D"
  },
  "message": {
    "imageMessage": {
      "url": "https://mmg.whatsapp.net/v/t62.7119-24/31809967_2958746007616712_3774955636954933761_n.enc?ccb=11-4&oh=01_Q5AaIPHnpFjuJwCULeqyHMcDO55BAj3YxolxEVLGXVvVkaKM&oe=67F2DD3D&_nc_sid=5e03e0&mms3=true",
      "mimetype": "image/jpeg",
      "fileSha256": "ubfaNZ4rY7T7/ghhWnBh1cVf1d00JSHENKunZuHs+yc=",
      "fileLength": 7200,
      "height": 200,
      "width": 200,
      "mediaKey": "ARUCxn91XDCjmCvFecREY4Fpg9RSOYa8O5D7TxGWGkE=",
      "fileName": "hypersender.jpeg",
      "fileEncSha256": "ER9FB+GEzrKmooWDbNpqenokG1mAtvbIU+Ceo7JeNwQ=",
      "directPath": "/v/t62.7119-24/31809967_2958746007616712_3774955636954933761_n.enc?ccb=11-4&oh=01_Q5AaIPHnpFjuJwCULeqyHMcDO55BAj3YxolxEVLGXVvVkaKM&oe=67F2DD3D&_nc_sid=5e03e0",
      "mediaKeyTimestamp": 1741390160,
      "caption": "dolore nulla nisi Duis",
      "jpegThumbnail": "/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wAARCAAgACADASIAAhEBAxEB/8QAGAABAQADAAAAAAAAAAAAAAAABQIDBAb/xAAqEAACAQQBAgUDBQAAAAAAAAABAgMABAURIRMxEiJRYXEUkbEVMkGhwf/EABcBAQEBAQAAAAAAAAAAAAAAAAACAQT/xAAdEQACAQUBAQAAAAAAAAAAAAAAAQIREiEiMwNB/9oADAMBAAIRAxEAPwDrctlBZDpRaaYjfPZRRSWGSyA6srEKeR1G19hVY2MZDMSTS+ZVJfR+dCmbm++nvoIG8AjkBLMx1rVDi67TePgHJZZHGjqox8I7mNtgfIpbE5QXo6UoCzKN8dmHrWW2vfqb6eBfA0caghlO97oS9T9NzAaLhQQ4Hse4/NDOVJQeDZw0b2+YuISvAUgn23xSF7Ym6yFvI6K8KKwcN/VXfWsrhpbNxFORonX7h6e1DrkslY+S4jLa/mRf9FCnb5KySwK2dibXIXEiIqQuoCBT96Gv3GRzKpF5l2EBHoO5/NVJf5HIjpRRkK3BEYPPyaUxOLFkOrKQ0zDXHZR6UJ60hBan/9k="
    }
  },
  "messageTimestamp": 1741390160,
  "status": "PENDING"
}
V2 Queued Response: All API requests in V2 are queued for improved reliability. You’ll receive an immediate response with a queued_request_uuid that you can use to check the actual message status.

​
Response Format

All requests return a queued response: 
{
    "queued": true,
    "message": "Processing your request...",
    "queued_request_uuid": "a0816120-7e37-4e8b-8cf3-92deb2cdc133",
    "queued_request_link": "https://app.hypersender.com/api/whatsapp/v2/{instance}/queued-requests/a0816120-7e37-4e8b-8cf3-92deb2cdc133"
}
Use the queued_request_link or the Get Queued Request endpoint to check the actual message response once it’s processed. More details on queued requests can be found in the Queued Requests Documentation.
Send videos to the chat.
This feature is only available for subscribed accounts.

​
You can send videos in two ways:

​
Provide a URL for the video.

send-video url
Please note that the URL must be publicly accessible and not require any authentication or special headers to access the file.You can send videos only in mp4 formats - so make sure the url contains the correct extension - what WhatsApp accepts.Max allowed file size is 20MB.

​
Send the video it self as a file upload.

send-video file
send-video
By specifying the asNote property to true, the video will be sent as a whatsapp note video.
send-video note

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept
string
Example:

"application/json"

​
Content-Type
string
Example:

"application/json"

Path Parameters

​
instance
string
required
Example:

"{{ instance_id }}"

Body

application/json

Require to use multipart/form-data

​
chatId
string
required

Contact number - learn what is chatId

Example:

"[email protected]"

​
url
string

url to send (required without file)

​
file
string

file to send (required without url)

​
filename
string

filename for the file

​
mimetype
string

mimetype for the file

​
caption
string

caption for the file

​
reply_to
string

reply to message id

Response

Successful response

​
key
object
​
message
object
​
messageTimestamp
string
​
status
string