ID Mapping
Translate Legacy List Id to Modern List Id
This API allows translation of legacy list id to list id. This is a temporary API allowed for mapping old id’s to new id’s and will expire on May 30th, 2025.
GET
Translate Legacy List Id to Modern List Id
Supported products
Supported products
Required Scopes
Required Scopes
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
FlowAuthorization Code
- Authorization URL
- https://app.hubspot.com/oauth/authorize
- Token URL
- https://api.hubapi.com/oauth/v1/token
Scopes1
crm.segments.read
Query Parameters
The legacy list id from lists v1 API.
Last modified on September 9, 2026