Send Media Message
Send images, videos, files, and audio clips
Reading time: 1 minute
Send Media Message
Send images, videos, files, and audio clips.
POST
{{base_url}}/w/message/mediaQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
phone_number_id | string | Yes | Phone number ID of the sender |
Method 1: Send via URL
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Recipient phone number |
type | string | Yes | Media type: image, video, audio, document, sticker |
link | string | Yes | Media URL (must start with https://) |
caption | string | No | Media description (not supported for audio and stickers) |
Method 2: Upload File
Content-Type: multipart/form-data
| Parameter | Type | Required | Description |
|---|---|---|---|
phone | string | Yes | Recipient phone number |
type | string | Yes | Media type: image, video, audio, document, sticker |
file | file | Yes | File to upload |
caption | string | No | Media description (not supported for audio and stickers) |
file_name | string | No | File name (for documents) |
Supported Media Types
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | No | JPG, PNG, WEBP - max 5 MB |
video | string | No | MP4, 3GP - max 16 MB |
audio | string | No | MP3, OGG, AMR - max 16 MB |
document | string | No | PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX - max 100 MB |
sticker | string | No | WEBP (512x512) - max 100 KB |
Media Tips:
- Use high-quality images but optimized for size
- Videos: prefer 720p or 1080p resolution
- Documents: ensure they are readable on mobile
Example: Upload Image
Example: Upload Imagebash
curl -X POST "{{base_url}}/w/message/media?phone_number_id=123456" \
-H "Accept: application/json" \
-H "X-Awal-Signature-256: sha256=abc..." \
-H "X-Timestamp: 1704124800" \
-H "X-Domain: your-workspace" \
-H "X-Client-ID: your-client-id" \
-F "phone=96650000000" \
-F "type=image" \
-F "file=@/path/to/image.jpg" \
-F "caption=Our new product is now available!"Related
ā Back to Messages
View Guide