Send Media Message

Sends images, audio, video, or stickers via a public URL. Supported types: image, video, audio, sticker.

POST/api/v1/contact/:phone/send-media-message

Note

Use only one media type per request: image, video, audio, or sticker.

Request Body Schema

application/json

phonestringrequired

Recipient phone number with country code

Example:+917838343515

image.linkstringoptional

Publicly accessible image URL (JPEG/PNG)

Example:https://example.com/photo.jpg

image.captionstringoptional

Caption text for the image

Example:Check this out!

video.linkstringoptional

Publicly accessible video URL (MP4)

Example:https://example.com/video.mp4

video.captionstringoptional

Caption text for the video

audio.linkstringoptional

Publicly accessible audio URL (MP3/OGG)

Example:https://example.com/audio.mp3

sticker.linkstringoptional

Publicly accessible sticker URL (WEBP)

Example:https://example.com/sticker.webp

Response Payload

200 OKapplication/json

successbooleanrequired

Whether request succeeded

data.message_idstringrequired

Platform message ID (wamid)

data.raw.messages[].idstringrequired

Meta message ID

Code Snippets & Examples

curl -X POST "https://app.chatofy.in/api/v1/contact/+917838343515/send-media-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image":{"link":"https://example.com/photo.jpg","caption":"Check this out!"}}'

Was this endpoint guide helpful?

Previous Endpoint

Send Interactive Message

Next Endpoint

Send Document

Enterprise SLA•99.99% Guaranteed

curl -X POST "https://app.chatofy.in/api/v1/contact/+917838343515/send-media-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image":{"link":"https://example.com/photo.jpg","caption":"Check this out!"}}'

200 OKapplication/json

{
  "success": true,
  "data": {
    "message_id": "wamid.HBgLMTIzNDU2...",
    "raw": {
      "messaging_product": "whatsapp",
      "contacts": [
        {
          "input": "+917838343515",
          "wa_id": "917838343515"
        }
      ],
      "messages": [
        {
          "id": "wamid.HBgLMTIzNDU2..."
        }
      ]
    }
  },
  "message": "Message sent successfully"
}

curl -X POST "https://app.chatofy.in/api/v1/contact/+917838343515/send-media-message" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"image":{"link":"https://example.com/photo.jpg","caption":"Check this out!"}}'

{ "success": true, "data": { "message_id": "wamid.HBgLMTIzNDU2...", "raw": { "messaging_product": "whatsapp", "contacts": [ { "input": "+917838343515", "wa_id": "917838343515" } ], "messages": [ { "id": "wamid.HBgLMTIzNDU2..." } ] } }, "message": "Message sent successfully" }