HUhubspot
Basic

Map IDs

Changed on

Map legacy list IDs to their corresponding new IDs in the HubSpot system. This endpoint is useful for migrating data from older systems to the current HubSpot structure, ensuring that all list references are updated correctly.

post/crm/lists/2026-09/idmapping

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/lists/2026-09/idmapping
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.segments.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.read

Request body

string[] required

Response

successful operation

missingLegacyListIdsstring[] required

An array of strings representing legacy list IDs that could not be found or migrated.

Changes

  • 2026-09e1dd745172d1Revision changes
    • info

      the security scope crm.segments.read was added to the endpoint's security scheme oauth2

    • info

      the security scope crm.lists.read was removed from the endpoint's security scheme oauth2

  • 2026-096d0e6dc36ca0Revision changes
    • info

      the security scope crm.segments.read was added to the endpoint's security scheme oauth2

    • info

      the security scope crm.lists.read was removed from the endpoint's security scheme oauth2