Upload Image, Video, or PDF

POST

/v1/support/upload

Uploads an image, video, or PDF file and returns a public URL you can use with other endpoints (e.g. imageUrl in Send Image, fileUrl in Send File, or video attachments).

Behavior:

Videos are automatically normalized for WhatsApp compatibility: converted to a standard MP4 container, encoded with H.264 video / AAC audio. If the original video has no audio track, a silent one is added — WhatsApp requires every video to include an audio stream.

Images and PDFs are stored as-is, no transformation.

⚠️ Size limits: images up to 5 MB, videos up to 16 MB, PDFs up to 100 MB. Files exceeding these limits are rejected.

Request

Header Params

Body Params multipart/form-dataRequired

Responses

🟢200OK

application/json

The file was uploaded successfully.

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/support/upload' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--form 'file=@""'

Response Example

200 - Success Example

{
    "url": "https://.../my-photo.jpg"
}

Modified at 2026-06-30 17:22:29

Get Channels

Upload Audio File