Send media messages

Media messages send an image, document, video, or audio file. You can reference the file by a public link or by a media ID you uploaded first.

POST/{phone-number-id}/messages

By link

{
  "messaging_product": "whatsapp",
  "to": "919867800451",
  "type": "image",
  "image": { "link": "https://example.com/photo.jpg", "caption": "Your order" }
}

By uploaded media ID

Upload the file first to get a media ID, then reference it. Uploading is useful for files you send often.

POST/{phone-number-id}/media

{
  "messaging_product": "whatsapp",
  "to": "919867800451",
  "type": "document",
  "document": { "id": "MEDIA_ID", "filename": "invoice.pdf" }
}

Swap type per file

Use type image, document, video, or audio, with a matching object. Captions are supported on image, video, and document.

Building an integration? If you hit a wall, message us and a developer will help, the only platform in India that answers you live on WhatsApp.

Ask us on WhatsApp