---
title: "Changes to Delete a List"
method: DELETE
path: "/crm/v3/lists/{listId}"
---

# Changes to Delete a List

`DELETE /crm/v3/lists/{listId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 57 revisions.

- **2026-08-27** (v3) `2e56a90bc1ec` — 2 info
- **2026-08-21** (v3) `2ba1203b03a0` — 2 info
- **2026-08-17** (v3) `b30ec906b483` — 1 info
- **2026-07-13** (v3) `67789812a095` — 1 breaking
- **2026-07-13** (v3) `6fb18be10d58` — 2 info
- **2026-06-15** (v3) `6fb18be10d58` — 2 info
- **2026-06-15** (v3) `489bcf949ab5` — 2 info
- **2026-06-03** (v3) `6fb18be10d58` — 2 info
- **2026-05-22** (v3) `9dd2c1d75e65` — 4 info
- **2026-05-04** (v3) `d50f0570b85e` — 1 info

## Changes

- **2026-08-27** (v3) `2e56a90bc1ec` — 2 info
  - the security scope `crm.segments.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.read` was removed from the endpoint's security scheme `oauth2`
- **2026-08-21** (v3) `2ba1203b03a0` — 2 info
  - the security scope `cms.membership.access_groups.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.write` was removed from the endpoint's security scheme `oauth2`
- **2026-08-17** (v3) `b30ec906b483` — 1 info
  - endpoint added
- **2026-07-13** (v3) `67789812a095` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (v3) `6fb18be10d58` — 2 info
  - the security scope `cms.membership.access_groups.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.write` was removed from the endpoint's security scheme `oauth2`
- **2026-06-15** (v3) `6fb18be10d58` — 2 info
  - the security scope `cms.membership.access_groups.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.write` was removed from the endpoint's security scheme `oauth2`
- **2026-06-15** (v3) `489bcf949ab5` — 2 info
  - the security scope `cms.membership.access_groups.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.write` was removed from the endpoint's security scheme `oauth2`
- **2026-06-03** (v3) `6fb18be10d58` — 2 info
  - the security scope `cms.membership.access_groups.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.write` was removed from the endpoint's security scheme `oauth2`
- **2026-05-22** (v3) `9dd2c1d75e65` — 4 info
  - the security scope `cms.membership.access_groups.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `ils-lists-read` was removed from the endpoint's security scheme `oauth2`
  - the security scope `ils-lists-write` was removed from the endpoint's security scheme `oauth2`
- **2026-05-04** (v3) `d50f0570b85e` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hubspot/apis/crm-lists/docs/crm/v3/lists/:listId/delete.md) · [API](https://skmtc.dev/hubspot/apis/crm-lists.md) · [Page](https://skmtc.dev/hubspot/apis/crm-lists/changes/crm/v3/lists/:listId/delete)