---
title: "Create Snapshot"
method: POST
path: "/webhooks-journal/snapshots/2026-03/crm"
tags: ["Advanced"]
---

# Create Snapshot

`POST /webhooks-journal/snapshots/2026-03/crm`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/webhooks-journal/snapshots/2026-03/crm`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

Create a batch of CRM object snapshots in HubSpot. This endpoint is used to capture the current state of specified CRM objects for later reference or analysis. It requires a JSON payload containing the details of the CRM objects to snapshot. This operation is exempt from daily and ten-secondly rate limits.

## Request body

- CrmObjectSnapshotBatchRequest
  - `snapshotRequests` CrmObjectSnapshotRequest[], required: An array of CrmObjectSnapshotRequest objects, each representing a request to create a snapshot for a specific CRM object. This property is required.
    - `objectId` integer, required: An integer representing the unique identifier of the CRM object for which the snapshot is requested.
    - `objectTypeId` string, required: A string representing the type identifier of the CRM object, specifying what kind of object it is within HubSpot.
    - `portalId` integer, required: An integer representing the unique identifier of the HubSpot account (portal) where the CRM object resides.
    - `properties` string[], required: An array of strings, each representing a property of the CRM object that should be included in the snapshot.

## Response `200`

successful operation

- CrmObjectSnapshotBatchResponse
  - `snapshotResponses` CrmObjectSnapshotResponse[], required: An array of CrmObjectSnapshotResponse objects, each representing the result of a snapshot operation for a specific CRM object. This property is required.
    - `objectId` integer, required: An integer representing the unique identifier of the CRM object for which the snapshot is taken.
    - `objectTypeId` string, required: A string indicating the type of the CRM object, such as contact, company, or deal.
    - `portalId` integer, required: An integer representing the unique identifier of the HubSpot portal associated with the CRM object.
    - `snapshotStatusId` string, uuid, required: A UUID string representing the status identifier of the snapshot request, indicating the current state of the snapshot process.

## Other responses

- `default`: An error occurred.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-05-27** `f9c7181056c5`: 1 info
  - api operation id `post-/webhooks-journal/snapshots/2026-03/crm_/webhooks-journal/snapshots/2026-03/crm` removed and replaced with `post-/webhooks-journal/snapshots/2026-03/crm`
- **2026-04-08** `b0d8bc008db9`: 1 info
  - api operation id `post-/webhooks-journal/snapshots/2026-03/crm_/webhooks-journal/snapshots/2026-03/crm` removed and replaced with `post-/webhooks-journal/snapshots/2026-03/crm`
- **2026-03-30** `dc2fdad57f7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/webhooks-journal/snapshots/2026-03/crm/post.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)