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-09/{appId}/views/migrate

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/extensions/cards-dev/2026-09/{appId}/views/migrate
  • 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

  • 2026-09de6dd5bf92b9Revision changes
    • info

      added the new optional request property

  • 2026-095e23d07dffc8Revision changes
    • info

      the endpoint scheme security developer_hapikey was added to the API

    • info

      the endpoint scheme security oauth2 was removed from the API