---
title: "POST /crm/lists/2026-03/idmapping"
method: POST
path: "/crm/lists/2026-03/idmapping"
tags: ["Basic"]
---

# POST /crm/lists/2026-03/idmapping

`POST /crm/lists/2026-03/idmapping`

## Request body

- string[]

## Response `200`

successful operation

- CrmListsPublicBatchMigrationMapping
  - `legacyListIdsToIdsMapping` CrmListsPublicMigrationMapping[], required
    - `legacyListId` string, required — The legacy list id for the list
    - `listId` string, required — The V3 list id for the list
  - `missingLegacyListIds` string[], required — A list of legacy list ids that were passed in but not found. It will be empty if no id's are missing

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)