---
title: "Delete a WhatsApp group"
method: DELETE
path: "/v2/groups/{id}"
tags: ["WhatsApp Groups"]
---

# Delete a WhatsApp group

`DELETE /v2/groups/{id}`

## Request

- Base URL: `https://api.spurnow.com`
- URL: `https://api.spurnow.com/v2/groups/{id}`
- Auth: HTTP bearer

Deletes the group at Meta — all participants including the business are removed and WhatsApp fires group_lifecycle_update (group_delete). The conversation row is kept with `lifecycleStatus: deleted`: the thread stays in the inbox read-only and history is never destroyed. Idempotent for already-deleted groups.

## Path parameters

- `id` number, required

## Response `200`

- GroupConversationDto
  - `id` number, required
  - `metaGroupId` string, nullable, required
  - `channelId` number, required
  - `requestId` string, nullable, required
  - `subject` string, nullable, required
  - `description` string, nullable, required
  - `notes` string, nullable, required: Internal group-level notes used as AI context. Never sent to WhatsApp.
  - `inviteLink` string, nullable, required
  - `profilePictureUrl` string, nullable, required: S3 URL of the group icon Meta accepted. Rendered by the UI; Meta stores its own copy for delivery to WhatsApp. Null if never set or if a subsequent update was rejected by Meta.
  - `lifecycleStatus` 'creating' | 'active' | 'suspended' | 'deleted', required
  - `conversationStatus` 'OPEN' | 'CLOSED', required
  - `assignedAgentId` number, nullable, required
  - `assignedTeamId` number, nullable, required
  - `lastMessageAt` string, date-time, nullable, required
  - `agentLastSeenAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Group still being created, channel not connected, or a mapped Meta error.
- `404`: Group conversation not found in this workspace.

---

[API](https://skmtc.dev/spurnow/apis/spur-apis.md) - [All operations](https://skmtc.dev/spurnow/apis/spur-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/spurnow/apis/spur-apis/revisions/27ca7bf002cb?raw)