---
title: "Cancel a subscription"
method: POST
path: "/payments-subscriptions/2026-09-beta/subscriptions/crm/{objectId}/cancel"
tags: ["Advanced"]
---

# Cancel a subscription

`POST /payments-subscriptions/2026-09-beta/subscriptions/crm/{objectId}/cancel`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/payments-subscriptions/2026-09-beta/subscriptions/crm/{objectId}/cancel`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.schemas.subscriptions.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.subscriptions.write`

Cancel an active commerce subscription using the subscription ID.

## Path parameters

- `objectId` integer, required

## Response `default`

An error occurred.

- Error: 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.
  - `category` string, required: The error category
  - `context` object: Context about the error condition
  - `correlationId` string, uuid, required: A unique identifier for the request. Include this value with any error reports or support tickets
  - `errors` ErrorDetail[]: further information about the error
    - `code` string: The status code associated with the error detail
    - `context` object: Context about the error condition
    - `in` string: The name of the field or parameter in which the error was found.
    - `message` string, required: A human readable message describing the error along with remediation steps where appropriate
    - `subCategory` string: A specific category that contains more specific detail about the error
  - `links` object: A map of link names to associated URIs containing documentation about the error or recommended remediation steps
  - `message` string, required: A human readable message describing the error along with remediation steps where appropriate
  - `subCategory` string: A specific category that contains more specific detail about the error

## Changes

- **2026-10-30** (2026-09-beta) `f687fd0095a3`: 2 info
  - the security scope `crm.schemas.subscriptions.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.subscriptions.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-08** (2026-09-beta) `6cba99a27eed`: 2 info
  - the security scope `crm.schemas.subscriptions.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.subscriptions.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-02** (2026-09-beta) `e9e1c95e4db4`: 2 info
  - the security scope `crm.schemas.subscriptions.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.subscriptions.write` was removed from the endpoint's security scheme `oauth2`
- **2026-07-13** (2026-09-beta) `29440b5c833a`: 1 info
  - endpoint added
- **2026-07-13** (2026-09-beta) `2a76d3de548c`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/hubspot/apis/crm-subscription-lifecycle/changes/payments-subscriptions/2026-09-beta/subscriptions/crm/:objectId/cancel/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-subscription-lifecycle.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-subscription-lifecycle/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-subscription-lifecycle/revisions/f687fd0095a3?raw)