HUhubspot
Basic

Delete

Changed on

Delete a specific list in your HubSpot account using its unique identifier. This operation will permanently remove the list and its associated data, ensuring it is no longer accessible.

delete/crm/lists/2026-09/{listId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/lists/2026-09/{listId}
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.write, crm.segments.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: cms.membership.access_groups.write, crm.lists.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.segments.read, crm.segments.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.read, crm.segments.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.read, crm.lists.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: cms.membership.access_groups.write, crm.segments.read

Path parameters

listIdstring required

The unique identifier of the list to delete.

Response

No content

Changes

  • 2026-09e1dd745172d1Revision changes
    • info

      the security scope crm.lists.write was added to the endpoint's security scheme oauth2

    • info

      the security scope cms.membership.access_groups.write was removed from the endpoint's security scheme oauth2

  • 2026-096d0e6dc36ca0Revision changes
    • info

      the security scope crm.lists.write was added to the endpoint's security scheme oauth2

    • info

      the security scope cms.membership.access_groups.write was removed from the endpoint's security scheme oauth2