Skip to content

Installation

There is nothing to install in HubSpot. Trading Cards runs at app.tradingcards.dev and reads from and writes to your portals through keys you give it.

Go to app.tradingcards.dev, enter your email address and click Email me a link. Open the email, click the button, then click Confirm and sign in. There is no password.

Your account is created on your first sign-in. Each link works once and expires after 10 minutes. The app is invite-only while in preview; use the address your invite was sent to. Details in Sign-in and accounts.

The first screen is Add your first portal:

  1. HubSpot portal ID: the number under your account name in HubSpot’s top right corner (also called the Hub ID).
  2. Name: anything you will recognise.

Click Add portal. You land on the portal’s page, where a step strip reads 1 Portal · 2 Keys · 3 Snapshot.

Under Keys there are two rows. Both keys are checked with HubSpot and stored encrypted.

KeyNeeded forHow to get it
Personal Access Key (Personal Access Key, pak-…)Installing Trading Cards apps, including TC-Snapshotsapp.hubspot.com/l/personal-access-key
Private App Token (Private App Token or service key, pat-…)Snapshots, and deploying recipes or snapshot assetsInstall TC-Snapshots on the Private App Token row (recommended), or Paste a key you made yourself

HubSpot Personal Access Key location in the Developer Overview

Save the Personal Access Key first. Then, on the Private App Token row, pick a platform version (Stable 2026.09 unless you need the beta), click Install TC-Snapshots, open the project in HubSpot and install the app, then Get a pairing code and enter it on TC-Snapshots’ home page in HubSpot. The page connects on its own. Full steps in Portals and keys.

Click Take a snapshot on the portal’s page, give it a name and click Snapshot. The app checks the key’s scopes, scans the portal, then captures everything the key can read. Watch it on Activity, or wait for the email. More in Snapshots.

  • An app: open Apps, pick one, click Deploy, choose a portal with a Personal Access Key. The install runs through the HubSpot CLI and the card appears on the relevant records. Updates and removal are covered in the web app overview.
  • Assets from a snapshot: open the snapshot, select items, click Deploy, choose a target portal with a Private App Token. The preflight shows what will be created before you confirm. See Deploying assets.
  • A recipe: build one from your snapshots first. See Recipes.

On the app’s page the ⋯ menu has Uninstall from portal. This removes the app from your installed list and, if you choose, its configuration file from the portal’s file manager. The HubSpot project itself is deleted by you in HubSpot; the app gives you the link.