Sign in

v1

latestOpenAPI 3.0.22026-08-045831103.6 KB
Messages

Send video message

Send a video message via WhatsApp Official. The video URL is sent directly to the Meta API (no upload required). Returns immediately with QUEUED status. The file must be a video format supported by Meta (e.g. video/mp4 or video/3gpp, H.264 video with AAC audio, max 16 MB); Meta validates the file and rejects unsupported formats or sizes.

post/v2/messages/video

Headers

api-tokenstring required

API Token

Request body

channel_account_idstring uuid required

UUID of the WhatsApp Official channel account

contact_idstring uuid required

UUID of the contact to send the video to

urlstring uri required

Direct URL of the video to send

captionstring

Optional caption for the video

chat_idstring uuid

Optional UUID of an existing chat. If not provided, the system will find or create a chat automatically.

Example request

{
  "channel_account_id": "550e8400-e29b-41d4-a716-446655440001",
  "contact_id": "550e8400-e29b-41d4-a716-446655440002",
  "url": "https://example.com/video.mp4",
  "caption": "Check out this video!",
  "chat_id": "550e8400-e29b-41d4-a716-446655440003"
}

Response

Video message queued for sending

statusinteger

Example response

{
  "status": 200,
  "data": {
    "success": true,
    "message_id": "550e8400-e29b-41d4-a716-446655440099",
    "chat_id": "550e8400-e29b-41d4-a716-446655440003",
    "status": "QUEUED"
  }
}