Skip to main content
POST
Send Video

Basic Usage


Request Body

Supported format: MP4. The video is automatically downloaded, uploaded to FlowIQ storage with a 1-year signed URL, then delivered via Meta.

Response

Success (200)

Error: Missing Required Field (400)


Integration Example


Media URLs

Ensure the video URL is publicly accessible. The API needs to download the file before uploading to Meta.

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: Bearer YOUR_BEARER_TOKEN

Body

application/json
phone_number
string
required

Recipient phone number with country code

Example:

"+27123456789"

message_type
enum<string>
required

Must be "video"

Available options:
video
Example:

"video"

media_url
string
required

Publicly accessible URL to the video file

Example:

"https://example.com/demo.mp4"

caption
string

Optional caption for the video

Example:

"Watch our demo video"

context_message_id
string

WhatsApp message ID to reply to

Example:

"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."

Response

Message sent successfully

success
boolean
Example:

true

message
string
Example:

"Message sent successfully"

data
object