Wawp WhatsApp API
HomePricing
HomePricing
WhatsApp
API Status
  1. ⛓️‍💥 Session - instances
  • ⛓️‍💥 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
    • Send Image
    • Send PDF
    • Send Voice
    • Send video
    • Send Link Preview
    • Send Location
    • Send poll
    • Send Contact Vcard
    • Mark message(s) as seen
    • Start typing
    • Stop typing
    • Reaction
    • Star/unstar a message
  • ℹ️ 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. ⛓️‍💥 Session - instances

Stop Session

POST
https://wawp.net/wp-json/awp/v1/session/stop
POST /session/stop
Performs a clean shutdown of a Wawp session while retaining the session record for later restart.
This is ideal for temporary suspensions (maintenance or troubleshooting) without losing configuration.
Clarify what persists (session metadata, QR state) and what’s released (active sockets).
Recommend using stop rather than delete when the intent is temporary pause.

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/session/stop?instance_id=123456789&access_token=123456789'

Responses

🟢200Success
application/json
Body

Example
{
    "name": "newsession",
    "status": "STOPPED",
    "config": {
        "metadata": {
            "user_id": "4580",
            "display_name": "Wawp support",
            "user_email": "email@sitename.tld",
            "access_token": "123456789",
            "instance_id": "123456789"
        }
    },
    "engine": []
}
🟠400Bad Request
🟠400Bad Request
🟠401Unauthorized
Modified at 2025-09-10 19:13:23
Previous
Start Session
Next
Restart Session
Built with