Send Media API

Api Docs Sending Media Messages

Method : POST | GET

Endpoint: {{ url('/') }}/send-media

Request Body : (JSON If POST)

Parameter Type Required Description
api_key string Yes API Key
sender string Yes Number of your device
number string Yes Recipient number ex 72888xxxx | 62888xxxx
media_type string Yes Allow: image, video, audio, document
caption string No Caption/message
footer string No Footer under message
url string Yes Direct URL of media (not Google Drive, Dropbox, etc.)
full number No Show full response from WhatsApp

Note: Make sure the url is a direct link, not a shared link from cloud storage.


Example Without full

JSON Request

{
    "api_key": "1234567890",
    "sender": "62888xxxx",
    "number": "62888xxxx",
    "media_type": "image",
    "caption": "Hello World",
    "footer": "Sent via mpwa",
    "url": "https://example.com/image.jpg"
}

URL Request

{{ url('/') }}/send-media?api_key=1234567890&sender=62888xxxx&number=62888xxxx&media_type=image&caption=Hello World&footer=Sent via mpwa&url=https://example.com/image.jpg

JSON Response

{
    "status": true,
    "msg": "Message sent successfully!"
}

Example With full

JSON Request

{
    "api_key": "1234567890",
    "sender": "62888xxxx",
    "number": "62888xxxx",
    "media_type": "image",
    "caption": "Hello World",
    "footer": "Sent via mpwa",
    "url": "https://example.com/image.jpg",
    "full": 1
}

URL Request

{{ url('/') }}/send-media?api_key=1234567890&sender=62888xxxx&number=62888xxxx&media_type=image&caption=Hello World&footer=Sent via mpwa&url=https://example.com/image.jpg&full=1

JSON Response

{
  "status": true,
  "data": {
    "key": {
      "remoteJid": "62888xxxx@c.us",
      "fromMe": true,
      "id": "3EB0C373B04BXXXXXXXXXXX"
    },
    "message": {
      "imageMessage": {
        "url": "https://mmg.whatsapp.net/o1/v/t24/f2/m269/AQOKz_WB7dPWFfryJk1K8Cg09KW81xBjZq-eCQkPli773uWKhUfXiQMvyAEoJupyQ6_1FZ2bdm8Bf9Fye3OhSo9Gfh5XXXXXXXXXXX...",
        "mimetype": "image/jpeg",
        "caption": "Hello World",
        "fileSha256": "aNp8bcfZwEVhdPJXWr6Pir1SzeekXXXXXXXXXXX=",
        "fileLength": "498",
        "height": 72,
        "width": 72,
        "mediaKey": "n4fHuJxnZbK6u3UpKFAQddtrpZRp8CxXXXXXXXXXXX=",
        "fileEncSha256": "KmFkZsVNfI4pwEE8yu6GsjLuIy7uwTtcXXXXXXXXXXX=",
        "directPath": "/o1/v/t24/f2/m269/AQOKz_WB7dPWFfryJk1K8Cg09KW81xBjZq-eCQkPli773uWKhUfXiQMvyAEoJupyQ6_1FZ2bdm8Bf9Fye3OhSXXXXXXXXXXX...",
        "mediaKeyTimestamp": "1755628853",
        "jpegThumbnail": "/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDXXXXXXXXXXX...",
        "viewOnce": false
      }
    },
    "messageTimestamp": "1755628853"
  }
}