Skip to Content
Public APISend Image Message

Send Image Message

Send an image to a customer with an optional caption. The image must be reachable at a public HTTPS URL.

Endpoint

POST https://apis.splashifypro.com/api/v1/public/message

Headers

HeaderValue
AuthorizationBasic YOUR_API_KEY
Content-Typeapplication/json

Request body

{ "phoneNumber": "919876543210", "callbackData": "order_12345", "type": "Image", "data": { "message": "This is a test", "mediaUrl": "https://your-cdn.example.com/image.jpg" } }
FieldRequiredNotes
phoneNumberyesRecipient phone
typeyesMust be "Image"
data.messageoptionalCaption rendered below the image. Supports *bold*, _italic_
data.mediaUrlyesPublic HTTPS URL. Allowed: image/jpeg, image/png. Max 5 MB

Example

curl -X POST https://apis.splashifypro.com/api/v1/public/message \ -H "Authorization: Basic YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "phoneNumber": "919876543210", "callbackData": "some_callback_data", "type": "Image", "data": { "message": "This is a test", "mediaUrl": "MEDIA_URL" } }'

Successful response — 201 Created

{ "result": true, "message": "Message queued for sending via Splashify Pro. Check webhook for delivery status", "id": "078fedfa-d3bd-4b6b-b555-ddc10d1f309c" }

Error — 400 Bad Request

{ "result": false, "message": "Please correct the following error - Customer has not messaged within last 24 hours" }

Tips

  • Sticker-pack images (low-res, transparent) sometimes render with a black background on iOS. Use a solid background.
  • WebP is allowed for stickers — see Send Sticker Message.
  • Animated GIFs — WhatsApp converts them to MP4 and shows them as autoplay video. Use Send Video Message for predictable behaviour.