Send Media Message to Contact
POST
/api/v1/{subdomain}/messages/media
Optionally creates a contact if it doesn't exist.
similar to text messages. You can only send media messages within 24 hours of the customer's last message to your business.
This window starts or refreshes whenever the customer messages or calls you. After this 24-hour window expires,
the media message will not be delivered. Use approved template messages instead for communication beyond the 24-hour window.
Request
Path Params
Body Params multipart/form-dataRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://whatsapp.qtap.chat/api/v1//messages/media' \
--form 'phone_number="+919909919284"' \
--form 'media_type="image"' \
--form 'media_url="https://cdn.pixabay.com/photo/2015/01/07/15/51/woman-591576_1280.jpg"' \
--form 'media_file=@""' \
--form 'caption="Check out our latest product catalog! 📱"' \
--form 'filename="Product_Catalog_2024.pdf"' \
--form 'contact="{
\"firstname\": \"John\",
\"lastname\": \"Doe\",
\"email\": \"john.doe@example.com\",
\"country\": \"India\",
\"groups\": \"VIP Customers,Newsletter Subscribers\"
}"'Response Response Example
200 - Example 1
{
"status": "success",
"message": "Media message sent successfully",
"data": {
"message_id": "wamid.HBgMOTE5ODEwNjAwMDAwFQIAERgSNUU1RjE4MUM0QjY5MjFFNzYzAA==",
"contact_id": 15,
"phone": "+919909919284",
"media_type": "image",
"media_url": "https://cdn.pixabay.com/photo/2015/01/07/15/51/woman-591576_1280.jpg",
"caption": "Check out our latest product catalog! 📱",
"filename": null,
"status": "sent",
"sent_at": "2024-02-08 14:30:25",
"chat_id": 8,
"contact_created": true,
"file_size_mb": 2.3
}
}