Video

Sends a WhatsApp video message to a recipient.

The video is sent using a publicly accessible video URL. WhatsApp will fetch the media from this URL and deliver it directly inside the chat.

Video messages are ideal when you want to:

Share product demos
Send tutorial videos
Deliver personalized video messages
Provide visual instructions
Send marketing or onboarding content

The recipient can play the video directly inside WhatsApp without leaving the conversation.

URL


https://api.messagesmart.nl/api/v1/whatsapp/messages/video

Headers

See Authentication.

Request body

Field	Type	Required	Notes
whatsAppBusinessPhoneNumberId	string	Yes	The WhatsApp Business phone number ID sending the message
to	string	Yes	Recipient phone number in E.164 format
videoUrl	string	Yes	Publicly accessible HTTPS URL of the video file
caption	string	No	Optional caption shown below the video

Video requirements

To ensure successful delivery:

The videoUrl must be publicly accessible (no authentication required)
The URL must use HTTPS
The video format must be supported by WhatsApp (e.g. MP4)
The file size must comply with WhatsApp media limits

Examples

JSON


{
  "whatsAppBusinessPhoneNumberId": "399750423212934",
  "to": "+31612345678",
  "videoUrl": "https://example.com/videos/demo.mp4",
  "caption": "Here is your product demo video."
}

cURL


curl -X POST "https://api.messagesmart.nl/api/v1/whatsapp/messages/video" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "whatsAppBusinessPhoneNumberId": "399750423212934",
    "to": "+31612345678",
    "videoUrl": "https://example.com/videos/demo.mp4",
    "caption": "Here is your product demo video."
  }'

Node.js


const response = await fetch(
  "https://api.messagesmart.nl/api/v1/whatsapp/messages/video",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MESSAGESMART_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      whatsAppBusinessPhoneNumberId: "399750423212934",
      to: "+31612345678",
      videoUrl: "https://example.com/videos/demo.mp4",
      caption: "Here is your product demo video.",
    }),
  }
);
 
const json = await response.json();
console.log(json);
 
if (!json.success) {
  throw new Error(`${json.error.code}: ${json.error.message}`);
}

Response

Success (200 OK)


{
  "success": true,
  "data": {
    "messaging_product": "whatsapp",
    "contacts": [
      {
        "input": "+31612345678",
        "wa_id": "31612345678"
      }
    ],
    "messages": [
      {
        "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
      }
    ]
  }
}

Notes

The returned data.messages[0].id is the WhatsApp message ID.
This endpoint confirms delivery to WhatsApp, not whether the user watched the video.

Validation error (400 Bad Request)


{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "VideoUrl is required",
    "httpStatus": 400,
    "details": null
  }
}

Common causes:

Missing videoUrl
Missing whatsAppBusinessPhoneNumberId
Invalid or inaccessible video URL

Provider error (502 Bad Gateway)


{
  "success": false,
  "error": {
    "code": "WHATSAPP_SEND_FAILED",
    "message": "Failed to send WhatsApp video message.",
    "httpStatus": 502,
    "details": {
      "provider": "meta",
      "raw": {}
    }
  }
}

This error indicates that WhatsApp (Meta) rejected or failed to process the request.