POST/api/public/v1/messages

Send media

Send an image, video, document or audio file by public URL.

Provide a publicly reachable https:// link to the file — WhatsApp downloads and delivers it. Set type to image, video, document or audio.

Body parameters

Field	Type	Required	Description
to	string	Required	Recipient number, e.g. `919876543210`.
type	string	Required	`image`, `video`, `document` or `audio`.
media.link	string	Required	Public `https://` URL of the file.
media.caption	string	optional	Caption text. Ignored for `audio`.
media.filename	string	optional	Display name for `document` files.

Example request

cURL

curl -X POST 'https://api.bigradar.io/api/public/v1/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "to": "919876543210",
    "type": "image",
    "media": {
      "link": "https://example.com/photo.jpg",
      "caption": "Here is your invoice"
    }
  }'

Response · 202

200 OK

{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "message_id": "wamid.HBgM...",
    "conversation_id": "a1b2c3d4-...",
    "to": "919876543210",
    "status": "queued",
    "timestamp": "2026-06-25T12:30:45Z"
  }
}

Size limits apply: images ~5MB (jpg/png), video ~16MB (mp4), documents ~100MB (pdf etc.), audio ~16MB. Media also requires an open 24-hour customer-service window.