Send Video

POST

/v1/whatsapp/service-account/sendVideo

Sends a WhatsApp video message (with an optional caption) from a workspace channel to a destination number. Same as Send Image, just for video.

Auth: Bearer token via the Authorization header, same as the other WhatsApp send endpoints.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The message has been accepted and queued for delivery.

Bodyapplication/json

🟠408

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/whatsapp/service-account/sendVideo' \
--header 'Authorization: Bearer eyJh......' \
--header 'content-type: application/json' \
--data '{
    "channelId": "YOUR_CHANNEL_ID",
    "videoUrl": "https://example.com/video.mp4",
    "toNumber": "966501234567",
    "caption": "Optional caption text"
}'

Response Example

200 - Success Example

{
    "contactId": "3a1e15...............",
    "status": "Sent",
    "message": "Message sent",
    "conversationEventId": "3a21f2..............."
}

Modified at 2026-06-29 12:09:56

Send Audio

Send File