Skip to content

Snapshots

A snapshot is a stored copy of a portal’s configuration, and optionally a sample of its records and activities, taken through the portal’s Private App Token. It is read-only: taking one changes nothing in HubSpot.

Snapshots are the raw material for recipes and can be deployed straight into another portal.

Open the portal’s page and click Take a snapshot. The button is disabled until a Private App Token is saved.

Give it a name and click Snapshot. The app captures every kind of configuration the key can read. Scope and scan checks run on their own and the capture starts when they pass.

Open Advanced options and switch What to capture to Choose. The wizard then walks through:

  1. What to capture: asset types, grouped as below. Picking a record type adds the schema it needs (property groups, properties, and pipelines for deals and tickets). Once a record type is chosen, Include activities adds notes, calls, emails, meetings and tasks on those records.
  2. Access: can the key read everything you chose? Missing scopes are listed with Copy scopes and Open HubSpot. Re-check after fixing them, or Continue without the types it cannot read.
  3. Scan: the app counts what is in the portal, type by type.
  4. Choose items: keep everything of a type (All) or Pick individual items by search and checkbox.

Advanced options → Schedule for later runs the capture at a chosen time. A scheduled snapshot captures the portal as it is when it runs, not as it is now. You get an email when it starts and when it finishes.

GroupAsset typesNotes
Data modelProperty groups, Properties, Pipelines and stages, Custom objects, Association labels, Lists and segmentsCustom objects need Enterprise.
AutomationWorkflows, SequencesSequences are read-only; they cannot be deployed.
MarketingForms, Marketing emails, Campaigns, Lead scores, Custom eventsLead scores use a beta API.
ContentHubDB tables, Knowledge base articlesKnowledge base articles use a beta API.
ReportingDashboardsDashboards can be captured but not deployed: HubSpot has no API to create reports.
CRM recordsContacts, Companies, Deals, Tickets, Custom object records, Owners and teamsAssociations between the chosen records come with them.
ActivitiesCalls, Emails, Meetings, Notes, TasksOn the chosen records only. Sales emails need the sales-email-read scope.
CommerceProducts, Line items, Quotes

Types HubSpot has no API for (Breeze agents, Reports, Saved views, Record layouts and cards) are shown greyed out as Not available by API. Website and landing pages and Files are listed as Coming soon.

Records are captured as example data, not as a full export. For each object you choose how to select them:

ModeWhat it takesLimit
SampleThe most recently updated records1 to 100
ListThe members of a HubSpot list1,000
FilterUp to three conditions on properties, all of which must match1,000
Pick recordsA live search by name, email or domain500

Activities are capped per record (1 to 100, default 25) and in total (2,500).

A complete snapshot opens in an explorer that works like a file manager:

  • Tabs for All and each asset type, with counts.
  • Search and filters within a type.
  • Checkboxes on rows, with Deploy and Add to recipe for the selection.
  • A details view for each item: its facts, a preview, a Comes with list of what it depends on, the raw definition, and Open in HubSpot.

Workflows are shown as words and as a top-down diagram: enrolment, each action, branches, and anything not connected.

The ⋯ menu on a snapshot has Export JSON, which downloads every captured item with its definition, and Delete snapshot, which removes the copy from Trading Cards and changes nothing in HubSpot. A running snapshot cannot be deleted; cancel it first from Activity.