# Delete contact group

> Delete a group and its memberships.

Source: https://sndr.sh/docs/cranl/contact-groups/delete-contact-group

`DELETE https://api.sndr.sh/api/cranl/v1/contact-groups/{id}`

Delete a group and its memberships. The contacts themselves are kept. A group that a broadcast still targets cannot be deleted.

Scope: `send`

**Path parameters**

- `id` (string, required): Group ID (grp_...).

**Request**

```bash
curl -X DELETE 'https://api.sndr.sh/api/cranl/v1/contact-groups/grp_4d8a0c5e-1f7' \
  -H 'Authorization: Bearer sndr_your_access_token'
```

**Response** (200)

```json
{
  "status": "ok"
}
```

**Errors**

- `unauthenticated` (401): Missing or invalid Bearer token.
- `token_expired` (401): Access token expired — exchange the refresh token for a new pair.
- `token_revoked` (401): Token was explicitly revoked.
- `insufficient_scope` (403): Token is missing the send scope.
- `not_found` (404): Resource does not exist or belongs to a different account.
- `group_in_use` (409): A broadcast still targets this group. Delete or retarget the broadcast first.
