Skip to main content
GET
/
crm
/
v3
/
lists
/
idmapping
Translate Legacy List Id to Modern List Id
curl --request GET \
  --url https://api.hubapi.com/crm/v3/lists/idmapping \
  --header 'Authorization: Bearer <token>'
{
  "legacyListId": "<string>",
  "listId": "<string>"
}

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.

Query Parameters

​
legacyListId
string

The legacy list id from lists v1 API.

Response

successful operation

​
legacyListId
string
required

The legacy list id for the list

​
listId
string
required

The V3 list id for the list

Last modified on December 16, 2025