Session Lifecycle
Documentation on Wawp's Session Lifecycle — how to provision, start, and maintain reliable WhatsApp instances.
Session Management Endpoints
Create Session
Provisions a fresh Wawp instance and returns metadata such as instance_id and session_name.
Start Session
Boots up the WhatsApp engine for a specific instance. This is the trigger that transitions a session from 'STOPPED' to 'STARTING'.
Stop Session
Gracefully shuts down the WhatsApp engine for an instance without logging it out. Used to save resources or restart a stuck session.
Restart Session
Reboots the WhatsApp instance. Useful for fixing stuck sessions or applying settings.
Session Rate Limits
View available rate-limit policies and the current policy for an instance. Paid users can select any policy; free users are limited to strict and standard policies.
Temporary Access Link
Generate, retrieve, or revoke a temporary access link for a WhatsApp session. The link opens a QR-code page that can be used to connect or reconnect the session without exposing your credentials.
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 Session
Permanently deletes a WhatsApp session locally and from the server. This action is irreversible.
Session Info
Retrieve complete information about a WhatsApp session, including connection status, authenticated user info, and server details.
About WhatsApp Data
Retrieves the profile information of the WhatsApp account connected to this session.
Webhook Management
Configures custom webhooks and toggles system webhook event forwarding for this session. (Paid users only)