Advanced

Migrate Card Views

Changed on

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

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

Request

  • Base URL
    https://api.hubapi.com
  • Auth
    API key in query parameter hapikey

Path parameters

appIdinteger required

The unique identifier of the app for which views are being migrated.

Request body

allowDuplicateAppCardIdsboolean required

A boolean flag indicating whether duplicate app card IDs are allowed during the migration process.

appCardIdinteger required

The unique identifier for the new app card to which views will be migrated. This is an integer in int64 format.

helpdeskAppCardIdinteger

The unique identifier for the helpdesk app card, if applicable. This is an integer in int64 format.

legacyCrmCardIdinteger required

The unique identifier for the legacy CRM card. This is an integer in int64 format.

tabAppCardIdinteger

Response

successful operation

endedAtinteger

The timestamp for when the migration ended.

messagestring required

A human readable message describing the progress of the migration.

remainingPortalCountinteger

The number of portals that remain to be swapped from the Legacy CRM Card to the App Card

startedAtinteger

The timestamp for when the migration started.

totalPortalCountinteger

The total number of portals that have access to the Legacy CRM Card

Changes

    • info

      added the new optional request property tabAppCardId

  • 2026-034e99ee6e4617Revision changes
    • info

      the endpoint scheme security developer_hapikey was added to the API

    • info

      the endpoint scheme security oauth2 was removed from the API