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>"
}

GET

crm

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

Required Scopes

Authorization

string

header

required

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

legacyListId

string

The legacy list id from lists v1 API.

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 February 12, 2026

⌘I