ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIMessagesSend Media Message

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:+919000000000
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

1curl -X POST "https://app.chatofy.in/api/v1/contact/+919000000000/send-media-message" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -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
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X POST "https://app.chatofy.in/api/v1/contact/+919000000000/send-media-message" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"image":{"link":"https://example.com/photo.jpg","caption":"Check this out!"}}'
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "message_id": "wamid.HBgLMTIzNDU2...",
5 "raw": {
6 "messaging_product": "whatsapp",
7 "contacts": [
8 {
9 "input": "+919000000000",
10 "wa_id": "919000000000"
11 }
12 ],
13 "messages": [
14 {
15 "id": "wamid.HBgLMTIzNDU2..."
16 }
17 ]
18 }
19 },
20 "message": "Message sent successfully"
21}