---
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: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

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

- CrmExtensionsCardsDevCardMigrateViewsRequest
  - `allowDuplicateAppCardIds` boolean, required
  - `appCardId` integer, required
  - `helpdeskAppCardId` integer
  - `legacyCrmCardId` integer, required

## Response `200`

successful operation

- CrmExtensionsCardsDevCardMigrateViewsResponse
  - `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

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-05-07** `24a387456830`: 4 info
  - added the optional property `endedAt` to the response with the `200` status
  - 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-08** `b0d8bc008db9`: 1 info
  - api operation id `post-/crm/extensions/cards-dev/2026-03/{appId}/views/migrate_/crm/v3/extensions/cards-dev/{appId}/views/migrate` removed and replaced with `post-/crm/extensions/cards-dev/2026-03/{appId}/views/migrate`
- **2026-03-25** `62586336cea2`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)