---
title: "Pause a subscription"
method: POST
path: "/payments-subscriptions/2027-03-beta/subscriptions/crm/{objectId}/pause"
tags: ["Advanced"]
---

# Pause a subscription

`POST /payments-subscriptions/2027-03-beta/subscriptions/crm/{objectId}/pause`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/payments-subscriptions/2027-03-beta/subscriptions/crm/{objectId}/pause`
- 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`

Pause an active subscription using the subscription ID.

## Path parameters

- `objectId` integer, required

## Request body

- PauseSubscriptionRequest
  - `pauseReason` string: A string indicating the reason for pausing the subscription.

## Response `default`

An error occurred.

## Changes

- **2026-10-10** (2027-03-beta) `5519029ee628`: 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`

[Operation history](https://skmtc.dev/hubspot/apis/crm-subscription-lifecycle/changes/payments-subscriptions/2027-03-beta/subscriptions/crm/:objectId/pause/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/5519029ee628?raw)