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.
Taking a snapshot
Section titled “Taking a snapshot”Open the portal’s page and click Take a snapshot. The button is disabled until a Private App Token is saved.
Automatic (default)
Section titled “Automatic (default)”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.
Choose what to capture
Section titled “Choose what to capture”Open Advanced options and switch What to capture to Choose. The wizard then walks through:
- 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.
- 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.
- Scan: the app counts what is in the portal, type by type.
- Choose items: keep everything of a type (All) or Pick individual items by search and checkbox.
Schedule for later
Section titled “Schedule for later”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.
What a snapshot can capture
Section titled “What a snapshot can capture”| Group | Asset types | Notes |
|---|---|---|
| Data model | Property groups, Properties, Pipelines and stages, Custom objects, Association labels, Lists and segments | Custom objects need Enterprise. |
| Automation | Workflows, Sequences | Sequences are read-only; they cannot be deployed. |
| Marketing | Forms, Marketing emails, Campaigns, Lead scores, Custom events | Lead scores use a beta API. |
| Content | HubDB tables, Knowledge base articles | Knowledge base articles use a beta API. |
| Reporting | Dashboards | Dashboards can be captured but not deployed: HubSpot has no API to create reports. |
| CRM records | Contacts, Companies, Deals, Tickets, Custom object records, Owners and teams | Associations between the chosen records come with them. |
| Activities | Calls, Emails, Meetings, Notes, Tasks | On the chosen records only. Sales emails need the sales-email-read scope. |
| Commerce | Products, 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
Section titled “Records”Records are captured as example data, not as a full export. For each object you choose how to select them:
| Mode | What it takes | Limit |
|---|---|---|
| Sample | The most recently updated records | 1 to 100 |
| List | The members of a HubSpot list | 1,000 |
| Filter | Up to three conditions on properties, all of which must match | 1,000 |
| Pick records | A live search by name, email or domain | 500 |
Activities are capped per record (1 to 100, default 25) and in total (2,500).
Browsing a snapshot
Section titled “Browsing a snapshot”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.
Export and delete
Section titled “Export and delete”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.