> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypersender.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Send Video
> Send videos to WhatsApp users via URL or file upload.
**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:
```json theme={null}
{
"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](/v2/api-reference/whatsapp/queued-requests/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](/v2/api-reference/whatsapp/queued-requests).
***
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.
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.
***
***
By specifying the `asNote` property to `true`, the video will be sent as a whatsapp note video.
## OpenAPI
````yaml v2/api-reference/whatsapp/whatsapp-collection.json POST /{instance}/send-video
openapi: 3.1.0
info:
version: v2.0
title: Hypersender WhatsApp API Docs
description: >
The Hypersender WhatsApp API is a powerful api to send and recieve messages
using your own whatsapp number.
Without the high costs of Meta's Whatsapp business API.
In this Docs you'll learn how to use and integrate Hypersnder Whatsapp API
into your existing system/service or application using simple API endpoints.
## What's New in V2?
**Queued Responses:** All requests in V2 are now queued for improved
reliability and performance. When you make a request, you'll receive an
immediate response with a `queued_request_uuid` that you can use to check
the status of your request.
**Example Response:**
```json
{
"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/{queued_request_uuid}"
}
```
Use the `queued_request_link` or the **Get Queued Request** endpoint to
check the actual message response once it's processed.
**What you can Do?**
- Send Text and basic Url messages.
- Send Media through Link or uploaded file.
- Send Audio through Link or uploaded file.
- Send Contact Card
- Send Location
- Send Poll votes
**You can also**
- React to a message
- Forward messages to other chats
- Acknowledge messages (mark as read)
- Star and unstar messages
**Quick Demo**
**Learn how to use Hypersender whatsapp API to send a message using Postman:**
[Demo Link](https://app.hypersender.com/send-whatsapp-message-in-postman) **to easily interact with our API.**
**postman collection**
You can download our [Postman
Collection](https://docs.hypersender.com/whatsapp-postman-collection.json)
to easily interact with our API.
## Servers (Endpoints)
- Production (activated):
[https://app.hypersender.com/api/whatsapp/v2](https://app.hypersender.com/api/whatsapp/v2)
servers:
- url: https://app.hypersender.com/api/whatsapp/v2
description: Production
security:
- Authorization: []
paths:
/{instance}/send-video:
post:
tags:
- Send Messages
parameters:
- name: Accept
in: header
schema:
type: string
example: application/json
examples:
default:
value: application/json
- name: Content-Type
in: header
deprecated: false
schema:
type: string
example: application/json
examples:
default:
value: application/json
- name: instance
in: path
required: true
schema:
type: string
example: '{{ instance_id }}'
examples:
default:
value: '{{ instance_id }}'
requestBody:
description: '**Require to use `multipart/form-data`**'
content:
application/json:
schema:
$ref: '#/components/schemas/SendVideoRequest'
examples:
Example 1:
value:
chatId: 11111111111@c.us
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
Example 2:
value:
chatId: 11111111111@c.us
file: hypersender.jpeg
fileName: hypersender_logo
mimetype: image
caption: string
reply_to: string
responses:
'201':
description: Successful response
content:
application/json:
schema:
allOf:
- type: object
properties:
key:
type: object
properties:
remoteJid:
type: string
fromMe:
type: boolean
id:
type: string
message:
type: object
properties:
imageMessage:
type: object
properties:
url:
type: string
mimetype:
type: string
fileSha256:
type: string
fileLength:
type: string
height:
type: number
width:
type: number
mediaKey:
type: string
fileName:
type: string
fileEncSha256:
type: string
directPath:
type: string
mediaKeyTimestamp:
type: string
caption:
type: string
jpegThumbnail:
type: string
messageTimestamp:
type: string
status:
type: string
x-examples:
Example 1:
content:
url: >-
https://mmg.whatsapp.net/o1/v/t62.7118-24/f1/m238/up-oil-image-4c847830-2a69-4ebd-ac45-f62c9a771a44?ccb=9-4&oh=01_Q5AaICe6iWwOjPuliG4zVq6gNXeUnijoMR_91jKzhLqNUlIB&oe=66B351C8&_nc_sid=000000&mms3=true
mimetype: image/png
caption: string
fileSha256: j/kM8e8A7qm5wi14X7dU5h0VUpbgAdxuAkuAZXqbv3Q=
fileLength: '188795'
mediaKey: r+N7EFTOq0IJGdGwKCZRS4/FMZYa4f0rLf3ASREmKSE=
fileEncSha256: 475YUJVkMeFChIuWFaWlLbfKHo3OK8+HGgndhNFZHiQ=
directPath: >-
/o1/v/t62.7118-24/f1/m238/up-oil-image-4c847830-2a69-4ebd-ac45-f62c9a771a44?ccb=9-4&oh=01_Q5AaICe6iWwOjPuliG4zVq6gNXeUnijoMR_91jKzhLqNUlIB&oe=66B351C8&_nc_sid=000000
mediaKeyTimestamp: '1720448410'
examples:
Example 1:
value:
key:
remoteJid: 1111111111@s.whatsapp.net
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
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ServerError'
security:
- Authorization: []
components:
schemas:
SendVideoRequest:
type: object
properties:
chatId:
type: string
description: >-
Contact number - **learn what is
[`chatId`](https://docs.hypersender.com/docs/whatsapp/what-is-chatid)**
example: 111111111111@c.us
url:
type: string
description: url to send (required without file)
file:
type: string
description: file to send (required without url)
filename:
type: string
description: filename for the file
mimetype:
type: string
description: mimetype for the file
caption:
type: string
description: caption for the file
reply_to:
type: string
description: reply to message id
required:
- chatId
ValidationError:
type: object
title: ValidationError
properties:
message:
type: string
errors:
type: object
description: Invalid or missing feilds will be shown here
statusCode:
type: number
example:
message: The given data was invalid.
errors: {}
statusCode: 422
required:
- errors
- statusCode
x-examples:
Multiple fields Error:
message: The given data was invalid.
errors:
messages:
- The number you want to send the message to is not on whatsapp.
jid: 20121323124131@s.whatsapp.net
exists: false
statusCode: 422
'Single Field error ':
message: The given data was invalid.
errors:
messages:
- textMessage.text should not be empty
statusCode: 422
x-stoplight:
id: 90x3wfxw7gqcb
ServerError:
type: object
title: ServerError
properties:
message:
type: string
example:
message: Internal Server Error
x-stoplight:
id: 2fhq2gihsfreh
securitySchemes:
Authorization:
type: http
scheme: bearer
````