Purge Stored Contacts
Permanently purge stored contacts and cached avatars from the Wawp cloud database for a specific instance or the entire user account.
Authentication Required
Login to swap the placeholders with your real Instance ID and Access Token.
Log InNo query parameters required
This endpoint doesn't expect data in the URL.
Best practices
Use scope='instance' to clear contacts for a single WhatsApp session, or scope='all' to clear the entire account.
Purging Cloud-Stored Contacts
The /v2/contacts/purge endpoint deletes synced contact records from the Wawp cloud database (wawp_contacts) and optionally removes cached avatar images from R2 cloud storage. It does not delete contacts from your mobile phone's address book.
Request Parameters
Configure the parameters required to interact with this endpoint. All query and body arguments are listed below with their details.
Query Parameters & Request Body
Supported in URL Query String or JSON Bodystring | Your unique WhatsApp Instance ID. Example: | ||
string | Your API Access Token. Example: | ||
string | — | Optional session name (alternative to instance_id). Example: | |
string | — | Purge scope: 'instance' (only this session) or 'all' (entire account). Default: instanceExample: | |
boolean | — | Whether to also delete cached contact profile pictures from cloud storage. Default: trueExample: |
Build with AI using Wawp MCP
MCP READYConnect Wawp API directly to Cursor, Windsurf, or Claude Desktop. Let AI write, test, and execute your WhatsApp integration code automatically!
Request Samples
Use these ready-to-go code snippets to integrate our API into your project quickly and efficiently. Choose your preferred language and library.
Expected Responses
Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.
Example
{
"status": "success",
"message": "Contacts for instance 123456789 have been purged successfully.",
"deleted_count": 240,
"scope": "instance"
}Command Palette
Search for a command to run...