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 Text

POST
https://wawp.net/wp-json/awp/v1/send
POST /send
Use for core text messaging. Required params: instance_id, access_token, chatId, message.
Positive UX: send instantly with optimistic UI ( show “typing...” then update on response).
Validate client-side length to match server MAX_TEXT_LENGTH to avoid roundtrips.
If upstream returns an empty 2xx body, treat as success but also poll message fetch for final delivery status.
Recommend showing copy for failed upstream (wawp_upstream_error) with retry button.

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 --request POST 'https://wawp.net/wp-json/awp/v1/send?instance_id=123456789&access_token=123456789&chatId=447441429009&message=Hi from Wawp'

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": "Hi from Wawp",
    "type": "chat",
    "t": 1759108610,
    "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,
    "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,
    "isAvatar": false,
    "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": []
  },
  "id": {
    "fromMe": true,
    "remote": "000000000000@c.us",
    "id": "MSG_ID_123456",
    "_serialized": "true_000000000000@c.us_MSG_ID_123456"
  },
  "ack": 0,
  "hasMedia": false,
  "body": "Hi from Wawp",
  "type": "chat",
  "timestamp": 1759108610,
  "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:35
Previous
Send Messages
Next
Send Image
Built with