Send a video message

Sends a video, optionally with a caption. Needs an open 24-hour window. Give the file as a public link or as an id from POST /v1/media/upload.

Example

curl -X POST "$HELLO_API_URL/v1/<your-phone-number-id>/messages" \
  -H "Authorization: Bearer $HELLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919999999999",
    "type": "video",
    "video": {
      "link": "https://example.com/tutorials/setup-in-60-seconds.mp4",
      "caption": "Setting up your device in 60 seconds"
    }
  }'

By media ID:

{
  "to": "+919999999999",
  "type": "video",
  "video": { "id": "1099999999995678" }
}

Response

202 Accepted (queued), or 200 with ?sync=true once WhatsApp accepts it. See Send a message.

Fields

Field	Type	Required	Description
`video.link`	string	One of `link` / `id`	Public HTTPS URL of the video
`video.id`	string	One of `link` / `id`	`media_id` from `/v1/media/upload`. Takes precedence if both are set.
`video.caption`	string	No	Text shown under the video

Supported formats: video/mp4 and video/3gpp (H.264 video with AAC audio), up to 16 MB.

Common errors

Status	`code`	Cause
`403`	`OUTSIDE_24H_WINDOW`	The recipient’s 24-hour window is closed
`400`	`VALIDATION_ERROR`	`video` is missing or the wrong shape
`422`	`SEND_FAILED`	(`?sync=true` only) WhatsApp rejected the send