Wawp WhatsApp API
HomePricing
HomePricing
WhatsApp
API Status
  1. 📤 Send Messages
  • ⛓️‍💥 Session - instances
    • Wawp’s Session Lifecycle
    • Create new Session
      POST
    • Start Session
      POST
    • Stop Session
      POST
    • Restart Session
      POST
    • Delete Session
      DELETE
    • Logout Session
      POST
    • Get Session info
      GET
    • About WhatsApp Data
      GET
  • 📲 Authentication - Login
    • About login authentication
    • GET QR raw
      GET
    • GET QR image
      GET
    • Request code
      POST
    • Get a live screenshot
      GET
  • 📤 Send Messages
    • Send Messages
    • Send Text
      POST
    • Send Image
      POST
    • Send PDF
      POST
    • Send Voice
      POST
    • Send video
      POST
    • Send Link Preview
      POST
    • Send Location
      POST
    • Send poll
      POST
    • Send Contact Vcard
      POST
    • Mark message(s) as seen
      POST
    • Start typing
      POST
    • Stop typing
      POST
    • Reaction
      PUT
    • Star/unstar a message
      PUT
  • ℹ️ Whatsapp Profile info
    • WhatsApp Profile Info
    • Get profile
    • Set display‑name
    • Set “About” status
    • Upload Whatsapp picture
    • Delete profile picture
  • 📢 Channels Control
    • Get list of know channels
    • Create a new channel.
    • Get channel info
    • Delete channel
    • Preview channel messages
    • Follow a channel
    • Unfollow a channel
    • Mute a channel
    • Unmute a channel
    • Search channels — by view
    • Search channels — by text
    • Search metadata — views / countries / categories
  • 🟢 Presence information
    • Presence API
    • Set session presence
    • Get the presence for the chat id
  • 🔊 24 Hour Status
    • Text status
    • Image status
    • Voice status
    • Video status
    • Delete status
  • 💬 Chats
    • Chats list & overview
    • chats overview
    • chats overview
    • Delete the chat
    • Get chat picture
    • Get messages in the chat.
    • Clear all messages from the chat.
    • Mark unread messages as read.
    • Get message by id
    • Delete a message
    • Edit a text message
    • Pin a message
    • Unpin a message
    • Archive the chat
    • Unarchive the chat
    • Mark chat as unread
  • 🪪 Contacts
    • Get all contacts
    • Get basic contact info
    • Check phone is on WhatsApp
    • Get contact “about”
    • Get contact profile picture (24h cache; add refresh=true to bust)
    • Block contact
    • Unblock contact
    • Create/Update contact on phone address book
    • Get all known lids to phone number mapping
    • Get the number of known lids
  • 👥 Groups
    • Get All List groups
    • Create a group
    • Join info (by code or URL)
    • Join group
    • Get the number of groups
    • Refresh groups from the server
    • Get the group
    • Delete the group
    • Leave the group
    • Get group picture
    • Set group picture
    • Delete group picture
    • Updates the group description
    • Updates the group subject
    • Updates the group "info admin only" settings
    • Update settings - who can send messages
    • Get settings - who can send messages
    • Set messages admin only
    • Get the invite code for the group
    • Invalidates the current group invite code and generates a new one
    • Get participants
    • Add participants
    • Remove participants
    • Promote participants to admin users
    • Demotes participants to regular users
  • 🏷️ Labels
    • Labels API
    • GET all labels
    • Create label
    • Update label
    • DELETE label
    • labels for a chat
    • Save labels for a chat
    • Chats with a label
  • 🪝 Webhooks
    • Wawp’s Webhook API
    • session.status
    • message
    • message.reaction
    • message.any
    • message.ack
    • message.revoked
    • message.edited
    • group.v2.join
    • group.v2.leave
    • group.v2.update
    • group.v2.participants
    • presence.update
    • poll.vote.failed
    • chat.archive
    • call.received
    • call.accepted
    • call.rejected
    • label.upsert
    • label.deleted
    • label.chat.added
    • label.chat.deleted
    • event.response
    • event.response.failed
    • engine.event
  1. 📤 Send Messages

Send Image

POST
https://wawp.net/wp-json/awp/v1/sendImage
POST /sendImage
SendImage expects a file object (url, mimetype, filename) and optional caption/reply_to.
💡
Positive UX comes from preview & validation: display a client-side thumbnail and validate URL/mimetype before invoking API.
Whatsapp Accept only png/Jpeg format,
For errors, show explicit messages for invalid_url or unsupported mimetype.
When successful, update chat UI with placeholder + final message metadata from upstream to avoid flicker.

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://wawp.net/wp-json/awp/v1/sendImage?instance_id=123456789&access_token=123456789&chatId=447441429009&file[url]=https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/1025px-Cat03.jpg&file[filename]=image.jpg&file[mimetype]=image/jpeg&caption=Here'\''s your requested image.'

Responses

🟢200Success
application/json
Body

Example
{
  "_data": {
    "id": {
      "fromMe": true,
      "remote": "000000000000@c.us",
      "id": "MSG_ID_123456",
      "_serialized": "true_000000000000@c.us_MSG_ID_123456"
    },
    "viewed": false,
    "body": "BASE64_IMAGE_DATA",
    "type": "image",
    "t": 1759108866,
    "from": {
      "server": "c.us",
      "user": "111111111111",
      "_serialized": "111111111111@c.us"
    },
    "to": {
      "server": "c.us",
      "user": "000000000000",
      "_serialized": "000000000000@c.us"
    },
    "ack": 0,
    "isNewMsg": true,
    "star": false,
    "kicNotified": false,
    "caption": "Here's your requested image.",
    "deprecatedMms3Url": "https://example.com/media-url",
    "directPath": "/media/direct/path/example",
    "mimetype": "image/jpeg",
    "filehash": "FILE_HASH_PLACEHOLDER",
    "encFilehash": "ENC_FILE_HASH_PLACEHOLDER",
    "size": 192487,
    "mediaKey": "MEDIA_KEY_PLACEHOLDER",
    "mediaKeyTimestamp": 1759108865,
    "streamable": false,
    "mediaHandle": null,
    "isFromTemplate": false,
    "pollInvalidated": false,
    "isSentCagPollCreation": false,
    "latestEditMsgKey": null,
    "latestEditSenderTimestampMs": null,
    "mentionedJidList": [],
    "groupMentions": [],
    "isEventCanceled": false,
    "eventInvalidated": false,
    "isVcardOverMmsDocument": false,
    "isForwarded": false,
    "isQuestion": false,
    "questionReplyQuotedMessage": null,
    "questionResponsesCount": 0,
    "readQuestionResponsesCount": 0,
    "labels": [],
    "hasReaction": false,
    "disappearingModeInitiator": "chat",
    "disappearingModeTrigger": "chat_settings",
    "productHeaderImageRejected": false,
    "lastPlaybackProgress": 0,
    "isDynamicReplyButtonsMsg": false,
    "isCarouselCard": false,
    "parentMsgId": null,
    "callSilenceReason": null,
    "isVideoCall": false,
    "callDuration": null,
    "callCreator": null,
    "callParticipants": null,
    "isCallLink": null,
    "callLinkToken": null,
    "isMdHistoryMsg": false,
    "stickerSentTs": 0,
    "lastUpdateFromServerTs": 0,
    "invokedBotWid": null,
    "bizBotType": null,
    "botResponseTargetId": null,
    "botPluginType": null,
    "botPluginReferenceIndex": null,
    "botPluginSearchProvider": null,
    "botPluginSearchUrl": null,
    "botPluginSearchQuery": null,
    "botPluginMaybeParent": false,
    "botReelPluginThumbnailCdnUrl": null,
    "botMessageDisclaimerText": null,
    "botMsgBodyType": null,
    "requiresDirectConnection": false,
    "bizContentPlaceholderType": null,
    "hostedBizEncStateMismatch": false,
    "senderOrRecipientAccountTypeHosted": false,
    "placeholderCreatedWhenAccountIsHosted": false,
    "galaxyFlowDisabled": false,
    "links": []
  },
  "mediaKey": "MEDIA_KEY_PLACEHOLDER",
  "id": {
    "fromMe": true,
    "remote": "000000000000@c.us",
    "id": "MSG_ID_123456",
    "_serialized": "true_000000000000@c.us_MSG_ID_123456"
  },
  "ack": 0,
  "hasMedia": true,
  "body": "Here's your requested image.",
  "type": "image",
  "timestamp": 1759108866,
  "from": "111111111111@c.us",
  "to": "000000000000@c.us",
  "deviceType": "android",
  "isForwarded": false,
  "forwardingScore": 0,
  "isStatus": false,
  "isStarred": false,
  "fromMe": true,
  "hasQuotedMsg": false,
  "hasReaction": false,
  "vCards": [],
  "mentionedIds": [],
  "groupMentions": [],
  "isGif": false,
  "links": []
}
🟠404invalid_instance
🟠401invalid_access_token
Modified at 2025-09-29 01:25:31
Previous
Send Text
Next
Send PDF
Built with