> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Map IDs > Mapper les ID de listes héritées à leurs nouveaux ID correspondants dans le système HubSpot. Ce point de terminaison est utile pour migrer des données d’anciens systèmes vers la structure HubSpot actuelle, garantissant que toutes les références de listes sont mises à jour correctement. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-lists-v2026-09.json POST /crm/lists/2026-09/idmapping openapi: 3.0.1 info: title: CRM Lists description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch - name: Search paths: /crm/lists/2026-09/idmapping: post: tags: - Basic summary: Mapper les ID description: >- Mapper les ID de listes héritées à leurs nouveaux ID correspondants dans le système HubSpot. Ce point de terminaison est utile pour migrer des données d’anciens systèmes vers la structure HubSpot actuelle, garantissant que toutes les références de listes sont mises à jour correctement. operationId: post-/crm/lists/2026-09/idmapping parameters: [] requestBody: content: application/json: schema: type: array items: type: string required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublicBatchMigrationMapping' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.segments.read - oauth2: - crm.lists.read components: schemas: PublicBatchMigrationMapping: required: - legacyListIdsToIdsMapping - missingLegacyListIds type: object properties: legacyListIdsToIdsMapping: type: array description: >- Un tableau d'objets PublicMigrationMapping qui mappent les ID des listes héritées à leurs nouveaux ID correspondants. items: $ref: '#/components/schemas/PublicMigrationMapping' missingLegacyListIds: type: array description: >- Un tableau de chaînes de caractères représentant les ID de listes héritées qui n'ont pas pu être trouvées ou migrées. items: type: string PublicMigrationMapping: required: - legacyListId - listId type: object properties: legacyListId: type: string description: >- L'ID de liste d'origine du système précédent. Il s'agit d'une chaîne qui représente l'ID de liste dans l'ancien système. listId: type: string description: >- Le nouvel ID de liste dans le système HubSpot. C'est une chaîne qui identifie de manière unique la liste dans le système actuel. Error: required: - category - correlationId - message type: object properties: category: type: string description: Une chaîne indiquant la catégorie de l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur l'erreur, représenté sous forme de carte de paires clé-valeur. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour l'instance d'erreur, utilisé à des fins de suivi et de débogage. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau d'objets ErrorDetail, chacun fournissant des informations supplémentaires sur les erreurs spécifiques qui se sont produites. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un objet contenant des liens connexes, représenté sous forme de mappage des noms de liens vers des URL. message: type: string description: >- Une chaîne qui fournit une description de l'erreur lisible par un humain. example: An error occurred subCategory: type: string description: >- Un objet représentant une classification plus spécifique de l'erreur au sein de sa catégorie. description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: >- Une chaîne représentant un code d'erreur spécifique qui identifie le type d'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur l'erreur, représenté comme une carte de chaînes de caractères vers des tableaux de chaînes de caractères, qui peut inclure des paramètres ou des valeurs spécifiques liés à l'erreur. example: '{missingScopes=[scope1, scope2]}' in: type: string description: "Une chaîne indiquant l'emplacement où l'erreur s'est produite, tel que «\_query\_», «\_header\_» ou «\_body\_»." message: type: string description: Une chaîne contenant une description de l'erreur lisible. subCategory: type: string description: >- Un objet fournissant une catégorisation supplémentaire de l'erreur, qui peut contenir des détails supplémentaires. description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: cms.membership.access_groups.write: '' crm.lists.read: '' crm.lists.write: '' crm.segments.read: '' crm.segments.write: '' ````