---
title: "Update a subscription."
method: PATCH
path: "/crm/objects/2026-03/subscriptions/{subscriptionId}"
tags: ["Basic"]
---

# Update a subscription.

`PATCH /crm/objects/2026-03/subscriptions/{subscriptionId}`

Update a specific subscription by its ID with new property values.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `idProperty` string

## Request body

- CrmObjectsSimplePublicObjectInput — Represents the input required to create or update a CRM object, containing an object with property names and their corresponding values.
  - `properties` object, required — Key value pairs representing the properties of the object.

## Response `200`

successful operation

- CrmSimplePublicObject — A simple public object.
  - `archived` boolean, required — Whether the object is archived.
  - `archivedAt` string, date-time — The timestamp when the object was archived, in ISO 8601 format.
  - `createdAt` string, date-time, required — The timestamp when the object was created, in ISO 8601 format.
  - `id` string, required — The unique ID of the object.
  - `objectWriteTraceId` string — A unique identifier for tracing the creation request.
  - `properties` object, required — Key-value pairs representing the properties of the object.
  - `propertiesWithHistory` object — Key-value pairs representing the properties of the object along with their history.
  - `updatedAt` string, date-time, required — The timestamp when the object was last updated, in ISO 8601 format.
  - `url` string — The URL associated with the object.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-03-30** `dc2fdad57f7f` — 3 info
  - api operation id `patch-/crm/objects/2026-03/subscriptions/{subscriptionId}_/crm/objects/2026-03/subscriptions/{subscriptionId}` removed and replaced with `patch-/crm/objects/2026-03/subscriptions/{subscriptionId}`
  - the security scope `crm.objects.listings.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.objects.deals.highly_sensitive.write` was removed from the endpoint's security scheme `private_apps`
- **2026-03-25** `62586336cea2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/crm/objects/2026-03/subscriptions/:subscriptionId/patch.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-service-production.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/dc2fdad57f7f/schema)