Skip to main content
PUT
/
crm
/
v3
/
lists
/
{listId}
/
update-list-name
Update List Name
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/lists/{listId}/update-list-name \
  --header 'Authorization: Bearer <token>'
{
  "updatedList": {
    "createdAt": "2023-11-15T18:16:52.165Z",
    "createdById": "123",
    "filtersUpdatedAt": "2023-11-15T19:03:24.160Z",
    "listId": "123",
    "listVersion": 2,
    "name": "Updated List Name",
    "objectTypeId": "0-1",
    "processingStatus": "COMPLETE",
    "processingType": "DYNAMIC",
    "updatedAt": "2023-11-15T19:03:32.979Z",
    "updatedById": "123"
  }
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
listId
string
required

The ILS ID of the list to update.

Query Parameters

​
includeFilters
boolean
default:false

A flag indicating whether or not the response object list definition should include a filter branch definition. By default, object list definitions will not have their filter branch definitions included in the response.

​
listName
string

The name to update the list to.

Response

Successful response, for a request with includeFilters set to false.

The updated definition of the list in response to a list update request.

​
updatedList
object

An object list definition.

Last modified on December 16, 2025