Home

Session Management

Explore all operations and guides for Session Management.

Session Lifecycle

Documentation on Wawp's Session Lifecycle — how to provision, start, and maintain reliable WhatsApp instances.

Session Management Endpoints

8 Endpoints
POST
/v2/session/create

Create Session

Provisions a fresh Wawp instance and returns metadata such as instance_id and session_name.

POSTGET
/v2/session/start

Start Session

Boots up the WhatsApp engine for a specific instance. This is the trigger that transitions a session from 'STOPPED' to 'STARTING'.

POSTGET
/v2/session/stop

Stop Session

Gracefully shuts down the WhatsApp engine for an instance without logging it out. Used to save resources or restart a stuck session.

POSTGET
/v2/session/restart

Restart Session

Reboots the WhatsApp instance. Useful for fixing stuck sessions or applying settings.

POSTGET
/v2/session/logout

Logout Session

Logs the instance out of WhatsApp. This removes the paired device link but keeps the instance alive in a 'SCAN_QR_CODE' state.

DELETE
/v2/session/delete

Delete Session

Permanently deletes a WhatsApp session locally and from the server. This action is irreversible.

POST
/v2/session/info

Session Info

Retrieve complete information about a WhatsApp session, including connection status, authenticated user info, and server details.

GET
/v2/session/me

About WhatsApp Data

Retrieves the profile information of the WhatsApp account connected to this session.