WhatsApp
  1. Send Messages
  • Contact Management
    • Create a New Contact
      POST
    • List Contacts
      GET
    • Get Contact Details
      GET
    • Update Contact Information
      PUT
    • Delete Contact
      DELETE
  • Status Management
    • Create Status
      POST
    • List Statuses
      GET
    • Get Status Details
      GET
    • Update Status
      PUT
    • Delete Status
      DELETE
  • Source Management
    • Create Source
      POST
    • List Sources
      GET
    • Get Source Details
      GET
    • Update Source
      PUT
    • Delete Source
      DELETE
  • Group Management
    • List Groups
      GET
    • Create Group
      POST
    • Get Groups Details
      GET
    • Update Groups
      PUT
    • Delete Group
      DELETE
  • Template Management
    • List Templates
      GET
    • Get Templates Details
      GET
  • Template Bot Management
    • List TemplateBot
    • Get TemplateBot Details
  • Message Bot Management
    • List Messagebots
    • Get Messagebots Details
  • Send Messages
    • Send Simple Message
      POST
    • Send Template Message
      POST
    • Send Media Message to Contact
      POST
WhatsApp
  1. Send Messages

Send Media Message to Contact

POST
/api/v1/{subdomain}/messages/media
Send a media message (image, document, video, audio) with optional text to a specific phone number via WhatsApp.
Optionally creates a contact if it doesn't exist.
Important - 24-Hour Customer Service Window: Media messages are subject to Meta's customer service window policy,
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.
File Size Limits:
Images: Max 5MB (JPEG, PNG, WebP)
Videos: Max 16MB (MP4, 3GPP)
Audio: Max 16MB (MP3, AAC, AMR, OGG)
Documents: Max 100MB (PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT)

Request

Authorization
Path Params

Body Params multipart/form-dataRequired

Responses

🟢200
application/json
success
Body

🟠403
🟠422
🔴500
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
    }
}
Previous
Send Template Message
Built with