---
title: subscriptionContractPause - Customer API
description: Pauses a Subscription Contract.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractPause
  md: >-
    https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractPause.md
api_name: customer
api_type: graphql
type: mutation
---

# subscription​Contract​Pause

mutation

Requires the `write_own_subscription_contracts` scope.

Pauses a Subscription Contract.

## Arguments

* subscription​Contract​Id

  [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

  required

  The ID of the subscription contract to pause.

***

## Subscription​Contract​Pause​Payload returns

* contract

  [Subscription​Contract](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContract)

  The updated Subscription Contract after the pause operation.

* user​Errors

  [\[Subscription​Contract​Status​Update​User​Error!\]!](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContractStatusUpdateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### subscriptionContractPause reference