> ## 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, crm, marketingLevel, salesLevel, serviceLevel, cmsLevel, dataLevel, commerceLevel, crmLevel}) => {
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",
crm: "Smart CRM"
},
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://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/MarketingHub.svg",
alt: "Marketing Hub"
}, {
name: sales ? translations.productNames.sales : '',
level: translateTier(salesLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SalesHub.svg",
alt: "Sales Hub"
}, {
name: service ? translations.productNames.service : '',
level: translateTier(serviceLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ServiceHub.svg",
alt: "Service Hub"
}, {
name: cms ? translations.productNames.cms : '',
level: translateTier(cmsLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ContentHub.svg",
alt: "Content Hub"
}, {
name: data ? translations.productNames.data : '',
level: translateTier(dataLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/DataHub.svg",
alt: "Data Hub"
}, {
name: commerce ? translations.productNames.commerce : '',
level: translateTier(commerceLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base/subscription_key_icons/commerce_icon.svg",
alt: "Revenue Hub"
}, {
name: crm ? translations.productNames.crm : '',
level: translateTier(crmLevel),
icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SmartCRM.svg",
alt: "Smart CRM"
}].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
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
A unique identifier for the request. Include this value with any
error reports or support tickets
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: further information about the error
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
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate
example: An error occurred
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error
description: >-
Represents an error response returned by the API when an operation
fails. This component is used in various endpoints to provide detailed
information about the error encountered.
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
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Context about the error condition
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: The name of the field or parameter in which the error was found.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error
description: >-
Represents detailed information about an error that occurred in the API.
This component is used to provide additional context and specifics about
errors, typically as part of an error response.
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}
)}