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

# Create Snapshot

`POST /webhooks-journal/snapshots/2027-03-beta/crm`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/webhooks-journal/snapshots/2027-03-beta/crm`
- Auth: none required

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.

## 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

- **2026-09-17** (2027-03-beta) `6995629a4549`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-08-14** (2027-03-beta) `0d8139833c65`: 1 info
  - api operation id `post-/webhooks-journal/snapshots/2027-03-beta/crm` removed and replaced with `post-/webhooks-journal/snapshots/2027-03-beta/crm_/webhooks-journal/snapshots/2027-03-beta/crm`
- **2026-08-13** (2027-03-beta) `e418414523e9`: 1 info
  - endpoint added

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

---

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