---
title: "Migrate Card Views"
method: POST
path: "/crm/extensions/cards-dev/2026-03/{appId}/views/migrate"
tags: ["Advanced"]
---

# Migrate Card Views

`POST /crm/extensions/cards-dev/2026-03/{appId}/views/migrate`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/extensions/cards-dev/2026-03/{appId}/views/migrate`
- Auth: API key in query parameter `hapikey`

Swaps a Legacy CRM Card with an App Card in views. Reference the "Migrate a legacy CRM card to an app card" docs for more information

## Path parameters

- `appId` integer, required

## Request body

- CardMigrateViewsRequest
  - `allowDuplicateAppCardIds` boolean, required: A boolean flag indicating whether duplicate app card IDs are allowed during the migration process.
  - `appCardId` integer, required: The unique identifier for the new app card to which views will be migrated. This is an integer in int64 format.
  - `helpdeskAppCardId` integer: The unique identifier for the helpdesk app card, if applicable. This is an integer in int64 format.
  - `legacyCrmCardId` integer, required: The unique identifier for the legacy CRM card. This is an integer in int64 format.
  - `tabAppCardId` integer

## Response `200`

successful operation

- CardMigrateViewsResponse
  - `endedAt` integer: The timestamp for when the migration ended.
  - `message` string, required: A human readable message describing the progress of the migration.
  - `remainingPortalCount` integer: The number of portals that remain to be swapped from the Legacy CRM Card to the App Card
  - `startedAt` integer: The timestamp for when the migration started.
  - `totalPortalCount` integer: The total number of portals that have access to the Legacy CRM Card

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-07** (2026-03) `00bdc803f052`: 1 info
  - added the new optional request property `tabAppCardId`
- **2026-09-22** (2026-03) `4e99ee6e4617`: 2 info
  - the endpoint scheme security `developer_hapikey` was added to the API
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-05-05** (2026-03) `38e36adc81a2`: 1 info
  - added the optional property `endedAt` to the response with the `200` status
- **2026-04-30** (2026-03) `38e0b07d28c1`: 3 info
  - added the optional property `remainingPortalCount` to the response with the `200` status
  - added the optional property `startedAt` to the response with the `200` status
  - added the optional property `totalPortalCount` to the response with the `200` status
- **2026-04-20** (2026-03) `d40f3fd42015`: 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `developer_hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/crm-public-app-crm-cards/changes/crm/extensions/cards-dev/2026-03/:appId/views/migrate/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-public-app-crm-cards.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-public-app-crm-cards/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-public-app-crm-cards/revisions/a5352fe9119f?raw)
