> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
---
id: 70dc5ed3-eaca-49c2-93cf-3d81e33f73ea
---
# Create CRM object snapshots
> Create a batch of CRM object snapshots for the specified portal. This endpoint allows you to capture the state of CRM objects at a specific point in time, which can be useful for auditing or historical analysis. The request requires a list of CRM object snapshot requests, each specifying the portal ID, object ID, object type ID, and properties to include in the snapshot.
export const SupportedProducts = ({marketing, sales, service, cms, data, commerce, marketingLevel, salesLevel, serviceLevel, cmsLevel, dataLevel, commerceLevel}) => {
const translations = {
description: "Requires one of the following products or higher.",
productNames: {
marketing: "Marketing Hub",
sales: "Sales Hub",
service: "Service Hub",
cms: "Content Hub",
data: "Data Hub",
commerce: "Revenue Hub"
},
tiers: {
free: "Free",
starter: "Starter",
professional: "Professional",
enterprise: "Enterprise"
}
};
const translateTier = tier => {
if (!tier) return '';
const lowerTier = tier.toLowerCase();
return translations.tiers[lowerTier] || tier;
};
const products = [{
name: marketing ? translations.productNames.marketing : '',
level: translateTier(marketingLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
alt: "Marketing Hub"
}, {
name: sales ? translations.productNames.sales : '',
level: translateTier(salesLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
alt: "Sales Hub"
}, {
name: service ? translations.productNames.service : '',
level: translateTier(serviceLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
alt: "Service Hub"
}, {
name: cms ? translations.productNames.cms : '',
level: translateTier(cmsLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
alt: "Content Hub"
}, {
name: data ? translations.productNames.data : '',
level: translateTier(dataLevel),
icon: "https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/subscription_key_icons/operations_icon.svg",
alt: "Data Hub"
}, {
name: commerce ? translations.productNames.commerce : '',
level: translateTier(commerceLevel),
icon: "https://developers.hubspot.com/hubfs/Knowledge_Base/subscription_key_icons/commerce_icon.svg",
alt: "Revenue Hub"
}].filter(product => product.name && product.level);
if (products.length === 0) return null;
return
{translations.description}
{products.map((product, index) =>
{product.name} -{product.level}
)}
;
};
## OpenAPI
````yaml specs/2026-03/webhooks-webhooks-v2026-03.json POST /webhooks-journal/snapshots/2026-03/crm
openapi: 3.0.1
info:
title: Webhooks Webhooks
description: Basepom for all HubSpot Projects
version: 2026-03
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
- name: Batch
paths:
/webhooks-journal/snapshots/2026-03/crm:
post:
tags:
- Advanced
summary: Create Snapshot
description: >-
Create a batch of CRM object snapshots for the specified portal. This
endpoint allows you to capture the state of CRM objects at a specific
point in time, which can be useful for auditing or historical analysis.
The request requires a list of CRM object snapshot requests, each
specifying the portal ID, object ID, object type ID, and properties to
include in the snapshot.
operationId: >-
post-/webhooks-journal/snapshots/2026-03/crm_/webhooks-journal/snapshots/2026-03/crm
parameters: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CrmObjectSnapshotBatchRequest'
required: true
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/CrmObjectSnapshotBatchResponse'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- webhooks-journal-snapshot-management
components:
schemas:
CrmObjectSnapshotBatchRequest:
required:
- snapshotRequests
type: object
properties:
snapshotRequests:
type: array
description: >-
An array of CrmObjectSnapshotRequest objects, each representing a
request to create a snapshot for a specific CRM object. This
property is required.
items:
$ref: '#/components/schemas/CrmObjectSnapshotRequest'
CrmObjectSnapshotBatchResponse:
required:
- snapshotResponses
type: object
properties:
snapshotResponses:
type: array
description: >-
An array of CrmObjectSnapshotResponse objects, each representing the
result of a snapshot operation for a specific CRM object. This
property is required.
items:
$ref: '#/components/schemas/CrmObjectSnapshotResponse'
CrmObjectSnapshotRequest:
required:
- objectId
- objectTypeId
- portalId
- properties
type: object
properties:
objectId:
type: integer
description: >-
An integer representing the unique identifier of the CRM object for
which the snapshot is requested.
format: int64
objectTypeId:
type: string
description: >-
A string representing the type identifier of the CRM object,
specifying what kind of object it is within HubSpot.
portalId:
type: integer
description: >-
An integer representing the unique identifier of the HubSpot account
(portal) where the CRM object resides.
format: int64
properties:
type: array
description: >-
An array of strings, each representing a property of the CRM object
that should be included in the snapshot.
items:
type: string
CrmObjectSnapshotResponse:
required:
- objectId
- objectTypeId
- portalId
- snapshotStatusId
type: object
properties:
objectId:
type: integer
description: >-
An integer representing the unique identifier of the CRM object for
which the snapshot is taken.
format: int64
objectTypeId:
type: string
description: >-
A string indicating the type of the CRM object, such as contact,
company, or deal.
portalId:
type: integer
description: >-
An integer representing the unique identifier of the HubSpot portal
associated with the CRM object.
format: int64
snapshotStatusId:
type: string
description: >-
A UUID string representing the status identifier of the snapshot
request, indicating the current state of the snapshot process.
format: uuid
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: The error category.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition, represented as an object with
additional properties.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
A unique identifier for the request, formatted as a UUID. This
should be included with any error reports or support tickets.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
An array providing further information about the error, with each
item being an ErrorDetail object.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
A map of link names to associated URIs containing documentation
about the error or recommended remediation steps, represented as an
object with string properties.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. It is a string.
example: An error occurred
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error, represented as a string.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: >-
The status code associated with the error detail. This string
provides a standardized error code for reference.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition, represented as an object where
each key is a context name and the value is an array of strings
providing further details.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: >-
The name of the field or parameter in which the error was found. It
is a string that helps identify the source of the error.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. This is a required field.
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error. This string helps further classify the error.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
developers-read: ''
developers-write: ''
private-apps-read: ''
private-apps-write: ''
webhooks-journal-data-access: ''
webhooks-journal-snapshot-management: ''
webhooks-journal-subscription-management: ''
webhooks-journal-subscription-read: ''
````
{product.name} -
{product.level}
)}