Skip to content

Send Image Message

Send Image Messages

Sends a message with an image attached via a URL.

Send a message that includes an image. Provide the image via a publicly accessible URL in the media_url parameter.

You can optionally include caption text in the message parameter.


💡 Note: Supported image formats: JPEG, PNG. Maximum file size: 5MB.


Parameters

Name Type Required Description
number string Yes Recipient phone number in any format (digits only extracted internally).
message string No Text content of the message. Required for text, buttons, interactive, and optional for others.
message_type string Yes Type of message to send. One of: text, image, video, audio, document, location, buttons, interactive.
media_url string Yes URL of media file (image/video/audio/document) to send, depending on message_type.
file_name string No File name for documents (e.g. document.pdf).
mimetype string Yes MIME type of media, e.g., image/jpeg, video/mp4, audio/mp4, application/pdf.
latitude number No Latitude coordinate for location messages.
longitude number No Longitude coordinate for location messages.
buttons array No Array of button objects for interactive messages. Each button should have buttonId and displayText.
quoted_message_id string No ID of the message to quote (reply to).
quoted_message string No Fallback text content for the quoted message if the original message is not found in the store.

API Endpoint

POST https://app.rapiwa.com/api/send-message
Content-Type: application/json
Authorization: Bearer Your_API_Key

Body

{
  "number": "88017XXXXXXXX",
  "message_type": "image",
  "message": "Here is an image for you!",
  "media_url": "https://rapiwa.com/xyz.jpg",
  "mimetype": "image/jpeg"
}

Response:

{
  "success": true,
  "message_type": "image",
  "message_id": "XXXXXXXXXXXXXXXXXXXXXX",
  "to": "88017XXXXXXXX"
}

💡 Tip: Keep your API Key secure. Never share it publicly.