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

Start Session

POST
https://wawp.net/wp-json/awp/v1/session/start
POST /session/start
transitions a provisioned Wawp instance into a running state.
This supports “start on demand” workflows to optimize resource usage and reduce costs during idle periods. It’s useful for scheduled activations or for resuming after maintenance.

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

Responses

🟢200Success
application/json
Body

Example
{
    "name": "newsession",
    "status": "STARTING",
    "config": {
        "metadata": {
            "user_id": "4580",
            "display_name": "Wawp support",
            "user_email": "email@sitename.tld",
            "access_token": "123456789",
            "instance_id": "123456789"
        }
    },
    "engine": {
        "grpc": {
            "client": "READY",
            "stream": "READY"
        },
        "gows": {
            "found": true,
            "connected": true
        }
    }
}
🟠400Bad Request
Modified at 2025-09-10 19:09:59
Previous
Create new Session
Next
Stop Session
Built with