← API Reference
Receiving Events

conversation.cleared

A conversation's history was cleared.

Event payload

{
  "id": "evt_c4d0b7a2e5",
  "type": "conversation.cleared",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T12:45:00Z",
  "data": {
    "conversation": { "id": "8613912345678@s.whatsapp.net", "type": "user" },
    "delete_media": true,
    "event": { "kind": "conversation_cleared" }
  }
}

Notes

  • The connected account cleared local message history for the conversation. data.conversation identifies the chat; delete_media=true means local media was cleared as well. The remote conversation and group membership are unchanged.