Retrieve ID Mapping
ID Mapping
Retrieve ID Mapping
Retrieve the mapping of legacy list IDs to their current IDs in the HubSpot system. This endpoint is useful for migrating or updating systems that rely on legacy list identifiers.
GET
Retrieve ID Mapping
Supported products
Supported products
Required Scopes
Required Scopes
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
The legacy list ID for which you want to retrieve the current ID mapping.
Last modified on August 6, 2026