Send View Once Media
Supported & TestedSend a view-once media message.
POSThttps://api.waplix.io/api/v1/messages/send-view-once
Authentication
Authorization: Bearer YOUR_API_KEY Parameters Specification
| Parameter | Type | Required | Description |
|---|---|---|---|
| instance_id | string | Required | Required Waplix instance id |
| chat_id | string | Required | Required phone number, @s.whatsapp.net, @g.us, or @lid chat id |
| type | string | Required | Required: image or video |
| media_url | string | Required | Required public http or https media URL |
| caption | string | Optional | Optional caption |
instance_id
stringReq Required Waplix instance id
chat_id
stringReq Required phone number, @s.whatsapp.net, @g.us, or @lid chat id
type
stringReq Required: image or video
media_url
stringReq Required public http or https media URL
caption
stringOpt Optional caption
Usage Notes
Verified on production. Public documentation uses sanitized example data only.
Request Payload Example
Request
curl -X POST "https://api.waplix.io/api/v1/api/v1/messages/send-view-once" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"instance_id": "demo_instance",
"chat_id": "15551234567@s.whatsapp.net",
"type": "image",
"media_url": "https://picsum.photos/200.jpg",
"caption": "View once image test"
}'Success Response
Response · 200 OK
{
"success": true,
"data": {
"instance_id": "demo_instance",
"chat_id": "15551234567@s.whatsapp.net",
"message_id": "MSG_DEMO_001",
"type": "view_once"
}
} Related Webhook Events
The API response confirms that Waplix accepted or processed the request. Delivery and read updates may arrive asynchronously through configured webhooks.
message.sent
Triggered when Waplix successfully sends the view once media message.
{
"event": "message.sent",
"instance_id": "demo_instance",
"chat_id": "15551234567@s.whatsapp.net",
"message_type": "view_once",
"message_subtype": "view_once",
"media_type": "image",
"message_id": "MSG_DEMO_001",
"timestamp": 1782582299
} Was this page helpful?